domain-modeling

Build and maintain project glossaries in CONTEXT.md and record architectural decisions as ADRs.

Updated Aug 29, 2026
One-click install
npx skills add https://github.com/1arley/volibear --skill domain-modeling-1arley
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: domain-modeling
Source: https://github.com/1arley/volibear/tree/main/.agents/skills/domain-modeling
Command: npx skills add https://github.com/1arley/volibear --skill domain-modeling-1arley

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 trade-offs. This Skill actively sharpens a project's domain model during design discussions and captures terms and decisions the moment they crystallize. ## Core Features & Use Cases - Glossary Management: Create and update CONTEXT.md files with opinionated, tightly-defined domain terms, including explicit "avoid" lists for ambiguous synonyms. - Architecture Decision Records: Write lightweight ADRs in docs/adr/ with sequential numbering, but only when a decision is hard to reverse, surprising without context, and the result of a real trade-off. - Multi-Context Support: Handle repos with multiple bounded contexts via a CONTEXT-MAP.md that lists contexts, their locations, and their relationships. - Use Case: While designing a billing feature, the user says "account" loosely. The Skill challenges the term, distinguishes Customer from User, updates CONTEXT.md inline, and offers an ADR when the team decides Billing communicates with Ordering via domain events instead of synchronous HTTP. ## Quick Start Ask the assistant to help define the domain terminology for your project and record it in a CONTEXT.md glossary as terms are resolved.

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 at the repo root listing each domain term with a one or two sentence definition and an avoid list of ambiguous synonyms. Add terms lazily as they are resolved during design discussions, and keep the file free of implementation details.

When should I write an architecture decision record?▼

Write an ADR only when all three conditions hold: the decision is hard to reverse, it is surprising without context, and it resulted from a real trade-off between genuine alternatives. If any condition is missing, skip the ADR to avoid documentation noise.

How do I handle multiple bounded contexts in one repository?▼

Create a CONTEXT-MAP.md at the repo root listing each context, where its CONTEXT.md lives, and how contexts relate to each other, such as event flows or shared types. Each context then maintains its own glossary and context-specific ADRs.

What format should an ADR follow?▼

ADRs live in docs/adr/ with sequential numbering like 0001-slug.md. The minimal template is a short title plus one to three sentences covering context, decision, and rationale; optional sections like Status or Considered Options are added only when they add genuine value.

What are the limitations of a CONTEXT.md glossary?▼

CONTEXT.md is a glossary only and must not contain implementation details, specs, or scratch notes. It covers terms specific to the project's domain, so general programming concepts like timeouts or error types do not belong even if used extensively.