domain-modeling

Installation
SKILL.md

Domain Modeling

The active discipline of shaping the model — challenging terms, inventing edge-case scenarios, and writing vocabulary down the moment it crystallizes. Merely reading a glossary for vocabulary is a one-line habit any skill does; this skill is for when you're changing the model, not consuming it.

Artifact

Maintain the project's glossary in its existing convention; a legacy CONTEXT.md counts. If there is none, create GLOSSARY.md at the repo root. A repo with several bounded contexts gets one glossary per context, plus a root GLOSSARY-MAP.md that points to each. Call the Skill tool with to-adr to record decisions that settle a term, so the why is preserved separately from the what.

Ubiquitous language

One term, one meaning, used everywhere — prose, code, docs, and the glossary agree. For each term write:

  • A crisp definition.
  • An Avoid list of the rejected synonyms, so the same concept never travels under two names.

When the same word means two things, that ambiguity is the work — split it into two named terms and retire the overloaded one.

Sharpen by stress

Installs
4
GitHub Stars
19
First Seen
Aug 23, 2026