domain-modeling

Maintain project domain models via CONTEXT.md glossary and ADR files.

2|Updated Jul 13, 2026
One-click install
npx skills add https://github.com/chichex/skills --skill domain-modeling-chichex
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: domain-modeling
Source: https://github.com/chichex/skills/tree/main/claude/domain-modeling
Command: npx skills add https://github.com/chichex/skills --skill domain-modeling-chichex

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill solves the problem of domain drift and architectural ambiguity by providing a structured, disciplined way to maintain a project's glossary and decision records.

Core Features & Use Cases

  • Glossary Management: Maintains a centralized CONTEXT.md to ensure consistent terminology across the codebase.
  • Architectural Decision Records (ADR): Provides a lightweight framework for documenting high-impact, hard-to-reverse technical decisions.
  • Use Case: When a team is debating whether to use a specific event-driven pattern, this skill helps evaluate the trade-offs and formally record the decision if it meets the criteria for an ADR.

Quick Start

Use the domain-modeling skill to review the current project glossary and check if the proposed architectural change qualifies for a new ADR.

Frequently Asked Questions about domain-modeling

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

FAQPage Schema
How do I maintain a centralized glossary for domain-driven design projects?

Maintain a centralized glossary by documenting project domain models in a CONTEXT.md file, ensuring consistent terminology across the codebase. This structured approach prevents domain drift and aligns team vocabulary.

When should I create an architectural decision record for a technical trade-off?

Create an architectural decision record when debating high-impact, hard-to-reverse technical trade-offs like adopting an event-driven pattern. ADRs provide a lightweight framework to formally evaluate and document these decisions.

What is the best way to document architectural decisions to prevent domain drift?

The best way to prevent domain drift is combining a centralized project glossary with architectural decision records. This structured documentation enforces strict terminology alignment and tracks high-impact technical decisions.

How do I format architectural decision records and glossary files correctly?

Format architectural decision records and glossary files by adhering to zero-contamination principles and specific formatting standards for CONTEXT.md and ADR files. This disciplined structure ensures documentation clarity.

Does this domain modeling approach work for software projects needing strict terminology alignment?

Yes, domain modeling applies directly to software development projects requiring strict terminology alignment. It maintains a centralized glossary and records high-impact technical decisions to resolve architectural ambiguity.