# Vocabulary

> Use when writing, reviewing, or naming any cc-suite artifact — pick the canonical noun or verb from this registry rather than coining a synonym. Loaded by NLPM's scorer and checker when R51 is enabled in .claude/nlpm.local.md.

- Skill: `xiaolai/vocabulary-4` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add xiaolai/vocabulary-4`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xiaolai/vocabulary-4/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: xiaolai (https://skillmd.com/u/xiaolai)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/xiaolai/vocabulary-4

---


# 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:check` and penalized by `/nlpm:score` when R51 is enabled.
>
> **Status:** seeded by `/nlpm:vocab-init` on 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 in `registry.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

1. Re-run extraction:

   ```bash
   python3 ${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/
   ```

2. New terms appear in `analysis/vocabulary-extract/summary.md`.
3. Add a row to the matching table above (Verbs or Nouns, in the correct scope). Cite at least one file as evidence.
4. To deprecate a synonym, add it to the canonical term's `deprecated:` list in `registry.yaml` AND update the "Enforced deprecation pairs" table above. Before doing this, run `grep -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`:

```yaml
rule_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-drift` periodically to surface new candidate pairs as the corpus grows.

## Example Invocations

<example>
Context: An author is naming a new action in a command file and wants the approved verb.
user: "My new command looks for outdated config entries — what should I call that action?"
assistant: "I'll check the vocabulary registry before naming it, so this lands on the canonical verb instead of coining a synonym that R51 will flag later."
</example>

<example>
Context: The scorer flagged a deprecated term and the author needs the canonical replacement.
user: "R51 flagged a deprecated synonym in this file — what am I supposed to write instead?"
assistant: "I'll look the flagged word up in the enforced deprecation pairs table below and use the canonical column's value as the replacement."
</example>