domain-modeling

Resolve ambiguous domain terminology and record architectural decisions in CONTEXT.md and ADR formats.

Updated Jun 26, 2026
One-click install
npx skills add https://github.com/yash-garg/pi-config --skill domain-modeling-yash-garg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: domain-modeling
Source: https://github.com/yash-garg/pi-config/tree/main/skills/domain-modeling
Command: npx skills add https://github.com/yash-garg/pi-config --skill domain-modeling-yash-garg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams resolve ambiguous domain concepts, maintain a shared language, and capture important architectural decisions before they become hidden assumptions.

Core Features & Use Cases

  • Domain Vocabulary Refinement: Challenges unclear terminology, distinguishes related concepts, and maintains a precise CONTEXT.md glossary.
  • Architectural Decision Recording: Identifies meaningful trade-offs and creates focused ADRs when decisions are difficult to reverse or require historical context.
  • Use Case: When a team is designing an ordering system and debates whether a customer, account, and user represent the same concept, use this Skill to define the correct domain boundaries and record the decision.

Quick Start

Ask the domain-modeling skill to review the current project terminology and help refine the domain model.

Frequently Asked Questions about domain-modeling

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

FAQPage Schema
How do I resolve ambiguous domain terminology like customer and user in a software design?

Resolving ambiguous domain terminology requires defining precise context boundaries and maintaining a shared ubiquitous language. This Skill challenges unclear concepts and records the refined definitions in a CONTEXT.md glossary to align domain concepts with implementation decisions.

When do I need to record an architecture decision record during domain modeling?

You need to record an architecture decision record when a design trade-off is difficult to reverse or requires historical context. This Skill identifies meaningful architectural trade-offs and creates focused ADRs to capture important software design decisions before they become hidden assumptions.

What is the best way to maintain a ubiquitous language across bounded contexts?

The best way to maintain a ubiquitous language is to distinguish related concepts and maintain a precise glossary. This Skill refines domain vocabulary by challenging unclear terminology and documenting the agreed-upon definitions within a CONTEXT.md file.

How do I document context boundaries and architecture trade-offs for a new ordering system?

Documenting context boundaries and architecture trade-offs requires aligning domain concepts with implementation decisions. This Skill helps you define correct domain boundaries for systems like an ordering platform and records the resulting architectural decisions in ADR documentation formats.

Does this domain modeling approach work without existing documentation formats?

This domain modeling approach requires maintaining specific documentation formats to function effectively. You must use and update CONTEXT.md for the domain glossary and ADR formats for architectural decisions to ensure domain concepts align with implementation choices.