ubiquitous-languagelisted
Install: claude install-skill DROOdotFOO/agent-skills
# ubiquitous-language
Extract canonical domain terminology from conversations. Be opinionated.
Flag ambiguity. Pick winners. Write `UBIQUITOUS_LANGUAGE.md`.
## Process
1. **Scan** -- Read the conversation (or codebase) for domain-specific terms
2. **Identify problems** -- Flag: ambiguous terms, synonyms used interchangeably,
overloaded terms (same word, different meanings in different contexts),
terms with no clear definition
3. **Propose canonical glossary** -- Pick one term per concept. Be opinionated.
If two terms compete, choose the more precise one and list the loser as
an alias to avoid
4. **Write file** -- Output `UBIQUITOUS_LANGUAGE.md` in the project root
5. **Merge on re-run** -- If the file exists, merge new terms into existing
tables. Flag conflicts between old and new definitions
## Output Format
Group terms into multiple tables by domain area (not one giant table).
```markdown
## [Domain Area Name]
| Term | Definition | Aliases to avoid |
| ------ | ----------------------------------------- | --------------------- |
| Ledger | Append-only record of all balance changes | log, journal, history |
### Relationships
- A Ledger contains many Entries (1:N)
- Each Entry references exactly one Account (N:1)
### Example dialogue
> "When a user transfers funds, a new Entry is appended to the Ledger."
> NOT: "When a user moves money, a new log item is added to the history."
### Flagged ambiguities
- "Account"