ubiquitous-language

name	ubiquitous-language
description	Ubiquitous language skill — evolve controlled vocabulary

Ubiquitous Language

Evolve the controlled vocabulary by identifying and defining new domain terms.

Arguments

$ARGUMENTS — Optional: path to a specific page to scan (e.g., wiki/daily/2024-03-15.md). If omitted, scans recent conversation context.

Behavior

Step 1 — Load the current vocabulary

Read UBIQUITOUS_LANGUAGE.md from the workspace root. Parse the three tables:

• Brands — product and company names
• Teams — team and group names
• Labels — domain-specific terms, acronyms, and jargon

Build a set of all currently defined terms.

Step 2 — Scan for undefined terms

If $ARGUMENTS specifies a page, read that page. Otherwise, review the recent conversation context.

Identify candidate terms that:

• Appear to be domain-specific (not common English words)
• Are used consistently (not one-off mentions)
• Are not already defined in UBIQUITOUS_LANGUAGE.md
• Could be brands, teams, or labels based on context

Step 3 — Propose additions

For each candidate term, propose a definition in the correct table format:

Proposed additions to UBIQUITOUS_LANGUAGE.md:

Brands:
| Term | Definition | Aliases |
| ---- | ---------- | ------- |
| NewBrand | Description of the brand | NB, nb |

Teams:
| Term | Definition | Aliases |
| ---- | ---------- | ------- |
| PlatformTeam | The infrastructure team | platform, plat |

Labels:
| Term | Definition | Aliases |
| ---- | ---------- | ------- |
| spike | Time-boxed investigation task | research spike |

If no new terms are found, report: "No new terms identified — vocabulary is up to date."

Step 4 — Write after confirmation

Present the proposed additions and ask: "Add these terms to UBIQUITOUS_LANGUAGE.md? You can accept all, select specific terms, or decline."

Only after explicit confirmation, append the accepted terms to the appropriate tables in UBIQUITOUS_LANGUAGE.md by editing the file directly.

Output

A list of proposed vocabulary additions with definitions, written only after user confirmation.