domain-modelinglisted
Install: claude install-skill ypxing/coding-crew
<what-to-do>
Maintain the project's domain documentation as understanding develops. When a term is resolved, update CONTEXT.md immediately. When an architectural decision qualifies, offer to record it as an ADR.
</what-to-do>
<supporting-info>
## File structure
Most repos have a single context:
```
/
├── CONTEXT.md
├── docs/
│ └── adr/
│ ├── 0001-event-sourced-orders.md
│ └── 0002-postgres-for-write-model.md
└── src/
```
If a `CONTEXT-MAP.md` exists at the root, the repo has multiple contexts. The map points to where each one lives:
```
/
├── CONTEXT-MAP.md
├── docs/
│ └── adr/ ← system-wide decisions
├── src/
│ ├── ordering/
│ │ ├── CONTEXT.md
│ │ └── docs/adr/ ← context-specific decisions
│ └── billing/
│ ├── CONTEXT.md
│ └── docs/adr/
```
Create files lazily — only when you have something to write. If no `CONTEXT.md` exists, create one when the first term is resolved. If no `docs/adr/` exists, create it when the first ADR is needed.
## Updating CONTEXT.md
When a term is resolved, update `CONTEXT.md` right away. Do not batch these up — capture them as they happen. Use the format in [references/context-format.md](references/context-format.md).
`CONTEXT.md` should be totally devoid of implementation details. Do not treat `CONTEXT.md` as a spec, a scratch pad, or a repository for implementation decisions. It is a glossary and nothing else.
### Challenge against the glossary
When a te