cc-suite Domain Vocabulary
The canonical noun-and-verb set for cc-suite. Every artifact name, prose description, and rule wording should draw from this registry. Drift between canonical terms and declared deprecated synonyms is flagged by
/nlpm:checkand penalized by/nlpm:scorewhen R51 is enabled.Status: seeded by
/nlpm:vocab-initon 2026-05-26 and pruned during the initial migration pass. Only deprecation pairs that can be cleanly enforced (no false positives in the current corpus) are inregistry.yaml. Other observed drift is documented below as convention-only with the rationale for non-enforcement.
Scopes
cc-suite has a single scope. Unlike NLPM (internal + auditor), cc-suite's artifacts all describe one system — the bridge between Claude Code, Codex CLI, and Antigravity CLI (agy).
| Scope | Paths | Description |
|---|---|---|
internal | commands/, skills/cc-suite/, templates/agents/, AGENTS.md | The cc-suite bridge subsystem itself. |
Enforced deprecation pairs (R51 will flag these)
These are clean drifts: the canonical term has fully replaced the deprecated one in the corpus, and the deprecated term has no remaining legitimate uses.
| Canonical | Deprecated synonym | Status |
|---|---|---|
dimension | pillar | Fully migrated (Mar 2026). All 5 audit-family commands now use Dimension N: headings and (N dimensions) phrasing. |
subagent | sub-agent | Fully migrated. The hyphenated form was a typo accident in agent-design SKILL.md and audit-agent.md. |
refresh | freshen | Fully migrated. freshen-aware / freshen semantics in AGENTS.md rewritten to refresh-aware / refresh semantics. |
Canonical-only verbs (no deprecation; just the canonical form)
Used to establish the cc-suite verb vocabulary so new artifacts pick from this set rather than coining synonyms. R51 doesn't penalize anything here because no observed drift exists.
| Canonical | Definition |
|---|---|
audit | Structured multi-dimension code/artifact scan with severity table (Codex-delegated). |
bridge | Umbrella verb for making one tool's config visible to another. |
update | User-side coupled re-render after claude plugin update cc-suite (slash command). |
init | First-time project setup of all cc-suite bridge artifacts. |
check | Lightweight prerequisite / connectivity probe. |
consult | Invoke a cc-suite advisor and receive its judgment. |
delegate | Forward a task to Claude Code via mcp__claude-code__claude_code. |
fix | Code-level remediation of a specific reported defect (distinct from repair). |
repair | Non-interactive re-run of all bridge / registration scripts (distinct from fix). |
verify | Confirm a prior code-fix outcome via Claude MCP. |
register | Persist an MCP server entry into .mcp.json or .codex/config.toml. |
expose | Symlink-based sub-operation of bridge for cc-suite plugin skills. |
mirror | One-directional copy sub-operation of bridge for hooks and MCP. |
setup | Higher-level user activity composed of init + configure + verify. |
review | Send a plan or PR to Codex for architectural review (distinct from consult). |
cancel continue implement plan analyze result status add remove list preflight unbridge | Single-command verbs; one canonical, no competing synonyms observed. |
Canonical-only nouns
| Canonical | Definition |
|---|---|
advisor | A project-scoped value-over-rules persona declared in .cc-suite/agents/, backed by claude-octopus as a separately-configured MCP server. |
bridge | The cc-suite-managed subsystem that wires Claude Code, Codex, and Antigravity (agy) together. |
finding | A single defect surfaced by an audit/review — file:line, severity, recommendation. Use in structured audit output (column headers, "Top Findings" sections, per-finding iteration in audit-fix/verify). |
sentinel block | The cc-suite-owned section in .codex/config.toml or .gitignore, delimited by sentinel comments. |
thread | The Codex execution-continuation handle (the threadId MCP parameter). |
registration | The persisted MCP server entry produced by bridge. |
preset | A starter advisor agent file shipped under templates/agents/. |
pin | The version string for claude-octopus in scripts/lib/claude-octopus-pin.txt. |
timeline | The per-advisor persistent consultation history at .cc-suite/agents/<name>/timeline/. |
artifact | A file cc-suite owns — command, skill, agent, hook, manifest, config. |
script | An executable under scripts/ — bash, python, or mjs. |
Role-noun suffixes for advisor preset names (intentional sub-variants)
These are not drift — each suffix encodes the persona's stance.
| Suffix | Stance | Example preset |
|---|---|---|
_advisor | General-purpose value advisor; broad-scope judgment. | north_star_advisor |
_reviewer | Reviews finished work against a single quality dimension. | clarity_reviewer |
_critic | Judges the output of an upstream process (typically docs). | documentation_critic |
_advocate | Argues for one specific action over alternatives. | deletion_advocate, simplicity_advocate |
_skeptic | Adversarial reviewer; assumes hostile inputs / worst case. | security_skeptic |
When introducing a new preset, pick the suffix that best matches its stance. Default to _advisor when none fit.
Why these pairs are convention-only (not enforced by R51)
The /nlpm:vocab-drift scan surfaced the drift candidates listed below. Each looks like a clean canonical/deprecated pair but turns out to be polysemous in cc-suite. R51 is mechanical — it flags every occurrence of a deprecated term regardless of context — so declaring these would generate false-positive penalties on legitimate uses. They are conventions, not rules:
| Concept pair | Why we don't enforce |
|---|---|
finding ← issue | finding is canonical for audit-output rows (column headers, Top Findings sections, per-finding iteration in audit-fix.md / verify.md). But issue legitimately means a different thing elsewhere: infrastructure problem in diagnose.md ("Found N issues. Fix them?"), implementation hiccup in implement.md ("Issues encountered"), code-quality category in audit prose ("minor clarity issues"). A blanket deprecation would mis-rename all three contexts. Convention: structured rows say Finding; everything else stays issue. |
advisor ← agent | advisor is canonical for cc-suite personas in prose. But agent is unavoidable in file paths (.cc-suite/agents/, templates/agents/), command names (add-agent, remove-agent, list-agents) — chosen to match Claude Code's .claude/agents/ convention — and refers to Claude Code's native subagent concept in design discussions. Convention: speak about "advisors" in prose; keep the file/dir/command layout using agent. |
thread ← session | thread is canonical for the Codex execution-continuation handle. session appears in continue.md's description as user-facing language ("Continue a previous Codex session"). Convention: prefer thread in technical contexts; tolerate session in user-facing descriptions. |
delegate ← ask / send | delegate is canonical in skill bodies. ask and send appear in description: frontmatter openings of the claude-* skills because they're more natural English for a one-line summary. Convention: skill body uses delegate; frontmatter description allows either. |
preset ← template | preset is the user-facing concept. template is the directory name (templates/agents/) and appears in add-agent.md frontmatter where it accurately describes what gets copied. Convention: speak about "presets" in prose; the on-disk word is template. |
verify ← check | verify is canonical for code-fix-outcome confirmation. check covers infrastructure probes (Step 2: Run additional deep checks in diagnose.md). Convention: don't conflate. |
How to extend
-
Re-run extraction:
bashpython3 ${CLAUDE_PLUGIN_ROOT:-~/.claude/plugins/cache/xiaolai/nlpm/1.0.0}/analysis/scripts/extract-vocabulary.py \ --root . \ --scopes analysis/vocab-init-scopes.json \ --out analysis/vocabulary-extract/ -
New terms appear in
analysis/vocabulary-extract/summary.md. -
Add a row to the matching table above (Verbs or Nouns, in the correct scope). Cite at least one file as evidence.
-
To deprecate a synonym, add it to the canonical term's
deprecated:list inregistry.yamlAND update the "Enforced deprecation pairs" table above. Before doing this, rungrep -r "<deprecated>"and confirm the term has no legitimate alternate meanings — if it does, document the pair in "Why these pairs are convention-only" instead.
Adopting R51
To turn on vocabulary drift detection on this project, add to .claude/nlpm.local.md:
yamlrule_overrides: R51: enabled: true vocabulary_skill: skills/cc-suite/vocabulary/
The pruned registry should produce zero R51 findings on the current corpus.
See also
- The corpus extractor:
${NLPM_ROOT}/analysis/scripts/extract-vocabulary.py - The six design principles:
${NLPM_ROOT}/analysis/vocabulary-design-principles.md - Run
/nlpm:vocab-driftperiodically to surface new candidate pairs as the corpus grows.
