ubiquitous-language

Ubiquitous Language

$ARGUMENTS

Extract and formalize domain terminology into a consistent glossary.

Usage

/ubiquitous-language [domain or context]

What This Command Does

1. Scans conversation for domain-relevant nouns, verbs, and concepts
2. Identifies ambiguities, synonyms, and overloaded terms
3. Proposes canonical glossary with opinionated term choices
4. Writes to UBIQUITOUS_LANGUAGE.md

Process

1. Scan conversation for domain terms
2. Identify problems:
   • Same word used for different concepts (ambiguity)
   • Different words used for same concept (synonyms)
   • Vague or overloaded terms
3. Propose canonical glossary
4. Write to UBIQUITOUS_LANGUAGE.md
5. Output summary inline

Output Format

# Ubiquitous Language

## {Domain Group}

| Term | Definition | Aliases to avoid |
|------|-----------|-----------------|
| **Order** | A customer's request to purchase one or more items | Purchase, transaction |

## Relationships

- An **Invoice** belongs to exactly one **Customer**

## Example dialogue

> **Dev:** "When a **Customer** places an **Order**..."
> **Domain expert:** "..."

## Flagged ambiguities

- "account" was used to mean both **Customer** and **User** — ...

Rules

• MUST be opinionated — pick the best term and list alternatives as aliases to avoid
• MUST flag every ambiguity (one word → two concepts) and every synonym (two words → one concept) with an explicit recommendation
• MUST write tight definitions (one sentence) that define what the term is, not what it does
• NEVER include generic programming concepts (array, function, endpoint, class) — this glossary is for the domain, not the toolchain
• NEVER silently overwrite an existing UBIQUITOUS_LANGUAGE.md — read the current file first, then update incrementally preserving prior decisions
• CRITICAL: show relationships with cardinality ("an Order belongs to exactly one Customer"). Vocabulary without relationships is a word list, not a language.
• MANDATORY: include 3-5 example dialogue exchanges showing correct usage. Abstract glossaries without dialogue rarely get adopted.