← ClaudeAtlas

domain-modelinglisted

Updates CONTEXT.md glossary and creates ADRs inline as design decisions crystallise. Use when you want to capture resolved domain terms or record architectural decisions during any session.
ypxing/coding-crew · ★ 0 · AI & Automation · score 60
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