Ground Domain Thinking

Domain thinking. Code mirrors business reality.

attac-t 20b88ad 2 files · 2.4 KB Updated

File contents

Skill: Domain Thinking

"Humans think in categories. Our code should be a reflection of that."

The Standard

  • Business Language: Name things as the client names them. Not technical jargon.
  • Group by Domain: Invoicing/, Shipping/, not Models/, Controllers/.
  • Translate, Don't Dictate: Your job is translator between business and code.

The Check

Ask yourself:

  • Would a domain expert recognize this folder structure?
  • Can I explain this class name to a non-developer?
  • Does the code reflect how the business actually works?

The Protocol

  1. Listen: Spend time with domain experts. Hear their language.
  2. Map: Create glossary of domain terms. Use them consistently.
  3. Structure: Group code by business domain, not technical layer.
  4. Evolve: Domains change. Refactor structure as understanding deepens.

Real-World Examples

See examples.md.

attac-t/the-foundry/tree/main/plugins/laravel-ddd/skills/ground-domain-thinking commit 20b88adfb5

Frequently asked questions

npx skillmds@latest add attac-t/ground-domain-thinking