domain-modeling

Clarify domain terminology and record architectural decisions in ADRs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you turn vague, conflicting, or overloaded project language into a clear domain model that everyone can share. It also captures important architectural decisions so future changes do not erase the reasoning behind them.

Core Features & Use Cases

  • Glossary building: Define the project’s core terms in a concise CONTEXT.md or CONTEXT-MAP.md so people use the same words for the same concepts.
  • Language refinement: Challenge ambiguous wording, propose sharper canonical terms, and separate similar concepts that should not be mixed.
  • Decision recording: Create lightweight ADRs for hard-to-reverse trade-offs, especially when the result would surprise a future reader.
  • Use case: A team is debating whether to call a person a customer, user, or account; this Skill helps resolve the term, document the meaning, and keep the project language consistent over time.

Quick Start

Use the domain-modeling skill to clarify the project’s terms, update the relevant CONTEXT.md entry, and record an ADR when a decision is hard to reverse.

Frequently Asked Questions about domain-modeling

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

FAQPage Schema
How do I resolve conflicting domain terminology in a software project?

To resolve conflicting domain terminology, normalize ambiguous terms into a canonical ubiquitous language. You challenge overloaded wording, propose sharper alternatives, and document agreed definitions in a shared CONTEXT.md file for consistent project usage.

What is the best way to record architectural decisions for hard-to-reverse trade-offs?

Recording architectural decisions for hard-to-reverse trade-offs is best done by creating lightweight Architecture Decision Records (ADRs). ADRs capture the context, clear trade-offs, and consequences of a choice so future readers understand the reasoning behind the result.

When do I need a context map for domain modeling?

You need a context map for domain modeling when separating similar concepts that should not be mixed. It clarifies boundaries between system parts, ensuring context-aware language updates do not overlap and cause ambiguous term overloading.

Can I use this to distinguish between similar terms like customer, user, and account?

Yes, you can use domain modeling to distinguish between similar terms like customer, user, and account. It facilitates term normalization by challenging ambiguous wording, proposing canonical terms, and separating concepts to maintain a precise shared glossary.

What are the limitations of using a lightweight ADR for architecture decisions?

The limitation of using a lightweight ADR is that it only captures durable architecture decisions with clear trade-offs and consequences. It focuses on lightweight capture rather than exhaustive documentation, meaning minor or easily reversible choices might not be recorded.