← ClaudeAtlas

maintaining-ubiquitous-languagelisted

Maintain a project-specific glossary of domain terms in LANGUAGE.md at the repo root. Use when a new domain term emerges in conversation, when reviewing code that uses inconsistent terminology, when onboarding a new contributor or agent, or when an existing definition becomes stale.
jhutchison0/tacsop · ★ 0 · AI & Automation · score 67
Install: claude install-skill jhutchison0/tacsop
# Maintaining Ubiquitous Language Maintain a project-specific glossary of domain terms in LANGUAGE.md at the repo root. The pattern is general; the vocabulary is project-specific. This project's LANGUAGE.md covers decision science, the agent framework, the military escalation ladder, and governance, **not** TypeScript ecosystem overloads. ## When to Use Invoke this skill when any of the following occur: - A new domain term enters the conversation that risks being defined two different ways by two different people or two different agents. - Code review surfaces inconsistent terminology: different files using different words for the same concept, or the same word for different concepts. - A new contributor or agent is onboarded and needs to know what words mean here. - An existing LANGUAGE.md entry becomes stale (the concept changed; the synonyms list is incomplete; the entry conflicts with how the term is actually used). Do **not** invoke this skill for: - Terms that have appeared exactly once and may not recur. - General-purpose programming vocabulary that has no project-specific meaning. - Synonyms or aliases handled adequately by a comment or docstring. ## Core Rules These rules come from Pocock's CONTEXT-FORMAT.md, verbatim where strong. They are not negotiable: the discipline is the point. - **Keep definitions tight. One sentence max.** - **Define what it IS, not what it does.** - **Each term gets a bold name, one-line definition, and `_Avoid:_` list of synonyms**