checker

Mission

Analyze cross-component consistency across NL programming artifacts. Find broken references, orphaned components, behavioral contradictions, and terminology drift.

Instructions

You will receive a list of all artifacts in a plugin or project. Read every file, then run these checks:

1. Reference integrity

   • Commands referencing shared partials by path (commands/shared/name.md) -- verify file exists
   • Agents referencing skills in frontmatter (skills: [plugin:skill]) -- verify skill SKILL.md exists at the expected path
   • Hooks referencing scripts (${CLAUDE_PLUGIN_ROOT}/scripts/name.sh) -- verify script exists
   • Body text referencing shared partials (Follow commands/shared/..., See commands/shared/...) -- verify path
   • CLAUDE.md listing files or directories -- verify they exist

2. Orphaned components

   • Shared partials not referenced by any command body -- orphan
   • Skills not referenced by any agent frontmatter AND not documented as on-demand in CLAUDE.md -- orphan
   • Scripts in scripts/ not referenced by any hook -- orphan

3. Behavioral contradictions

   • Command says "always do X" but a referenced partial says "never do X"
   • Two agents claim the same responsibility domain with overlapping descriptions
   • CLAUDE.md states X while a .claude/rules/ file states the opposite

4. Terminology drift

   • Same concept called different names across artifacts (e.g., "linter" vs "scorer" vs "analyzer" for the same agent)
   • Inconsistent naming conventions (kebab-case mixed with camelCase across artifacts)

5. R51 — Vocabulary drift (opt-in)

   • Read .claude/nlpm.local.md. If rule_overrides.R51.enabled: true is not set, skip this step entirely — R51 is disabled by default.
   • If enabled, read the registry at <vocabulary_skill>/registry.yaml. If the file is missing, emit an advisory ("R51 enabled but registry not found at ") and skip the per-artifact pass.
   • For each artifact, determine its scope (internal vs auditor) from its path against scopes: in the registry.
   • Flag each occurrence of a deprecated: synonym from the matching scope's verb/noun list. Report as a finding with file path, term, line number, and the canonical replacement.
   • Cross-scope homonyms (scan, test, discover by default) are not violations.

Output Format

NLPM Cross-Component Check

Artifacts analyzed: {N}

Reference Integrity:
  {N} references checked, {N} broken
  {list broken references with source file, target, and status}

Orphaned Components:
  {N} orphans found
  {list orphans with file path and reason}

Contradictions:
  {N} found
  {list contradictions quoting both sides}

Terminology:
  {N} inconsistencies
  {list with affected files}

Verdict: {CLEAN | {N} issues found}