domain-modeling

Builds and maintains project domain glossaries and architecture decision records.

10|3|Updated Jul 18, 2019
One-click install
npx skills add https://github.com/tanqimin/MyFavsORM --skill domain-modeling-tanqimin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: domain-modeling
Source: https://github.com/tanqimin/MyFavsORM/tree/main/.agents/skills/domain-modeling
Command: npx skills add https://github.com/tanqimin/MyFavsORM --skill domain-modeling-tanqimin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams lose shared understanding of domain terminology and forget why key architectural decisions were made, leading to inconsistent language in code and repeated re-litigation of settled choices. ## Core Features & Use Cases - Glossary Management: Creates and updates CONTEXT.md files that define canonical domain terms, flag ambiguous vocabulary, and list words to avoid. - Architecture Decision Records: Writes lightweight ADRs in docs/adr/ when decisions are hard to reverse, surprising, or the result of real trade-offs. - Multi-Context Support: Handles single-context repos with one CONTEXT.md or multi-context repos via a CONTEXT-MAP.md linking per-context glossaries. - Use Case: While designing an ordering system, the user says "account" loosely; the skill challenges the term, resolves it to "Customer", updates CONTEXT.md immediately, and offers an ADR when the team picks event-sourced writes over a CRUD model. ## Quick Start Ask the assistant to help define the domain terms for your project and record them in a CONTEXT.md glossary as you discuss the design.

Frequently Asked Questions about domain-modeling

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a domain glossary for my codebase?

Create a CONTEXT.md file at the repository root listing each domain term with a one or two sentence definition and an Avoid line for rejected synonyms. Update it inline whenever a term is resolved during design discussions.

When should I write an architecture decision record?

Write an ADR only when a decision is hard to reverse, surprising without context, and the result of a real trade-off between alternatives. If any of the three conditions is missing, skip the record.

What is the difference between CONTEXT.md and CONTEXT-MAP.md?

CONTEXT.md is a single glossary for repos with one domain context. CONTEXT-MAP.md is used in multi-context repos to list each context, link to its own CONTEXT.md, and describe relationships between contexts.

Where should ADR files be stored in a repository?

ADRs live in docs/adr/ with sequential numbered filenames like 0001-slug.md. The directory is created lazily only when the first ADR is needed, and multi-context repos can have per-context adr folders.

What should not go into a domain glossary?

Exclude general programming concepts like timeouts or error types, and exclude all implementation details. CONTEXT.md is purely a glossary of terms unique to the project's domain, not a spec or design document.