Agent skill · shipshitdev
domain-modeling
Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a CONTEXT.md, or recording or editing an ADR.
What it needs
About 2k tokens when loaded.
What this skill does
Domain Modeling Actively build and sharpen the project's domain model while designing. Challenge terms, invent edge-case scenarios, and write the glossary and decisions down the moment they crystallise. Reading CONTEXT.md for vocabulary is not this skill — that is a one-line habit any skill can do. This skill is for changing the model, not just consuming it. Contract Inputs: A term, relationship, or decision under discussion Existing CONTEXT.md / CONTEXT-MAP.md and docs/adr/ when present docs/agents/domain.md when setup-agent-routing has already configured layout Outputs: Updated glossary entries in CONTEXT.md Optional ADR when the three-gate filter passes Creates/Modifies: CONTEXT.md (or a per-context CONTEXT.md listed in CONTEXT-MAP.md) docs/adr/NNNN-slug.md when an ADR is warranted Directories created lazily — only when there is something to write External Side Effects: Local file writes only. No tracker writes. Confirmation Required: Before creating the first CONTEXT.md in a repo that had none Before writing an ADR Delegates To: None. grilling and interview invoke this skill when a term crystallises. File structure Most repos have a single context: If a CONTEXT-MAP.md exists at the root, the repo has multiple contexts. The map points to where each one lives. Prefer the layout already recorded in docs/agents/domain.md when that file exists. Create files lazily — only when there is 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. During the session Challenge against the glossary When the user uses a term that conflicts with the existing language in CONTEXT.md, call it out immediately. "The glossary defines 'cancellation' as X, but this sounds like Y — which is it?" Sharpen fuzzy language When the user uses vague or overloaded terms, propose a precise canonical term. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills shipshitdev/domain-modeling--06373a