Skip to main content
VOIDFORGE

/AUDIT-DOCS

Coulson

A lean, code-free audit of the documentation corpus only. A Surfer-led doc roster — Troi, Wong, Irulan, Coulson — hunts four classes of defect: doc-currency drift, broken cross-references, command↔method desync, and version-SSOT inconsistency. Report-only — it reads no application source, runs no build, and writes no fixes.

Coulson avatarCoulson

USAGE

/audit-docs [--focus "topic"] [--light] [--solo]

WHAT HAPPENS

  1. 1Launch the Silver Surfer, then deploy the doc-only roster it returns (no code-review agents)
  2. 2Scope the corpus — CLAUDE.md, README, Holocron, PRD, method docs, command specs, VERSION.md, ADR index
  3. 3Wong audits doc-currency drift — every factual claim verified against the live artifact
  4. 4Irulan walks every internal reference — file links, ADR numbers, table entries — and flags broken cross-references
  5. 5Troi checks command↔method desync — each command's steps, flags, roster, and gating against its method doc
  6. 6Coulson reconciles every version string against the single source of truth (the SSOT wins; downstream copies follow)
  7. 7Conflicts resolved via the debate protocol — Troi arbitrates, no dual opinions left standing
  8. 8Findings synthesized into one table with severity and confidence; report written to /logs/doc-audit.md

THE ARMORY

Toggle flags to forge your command. — Bilbo

--focusvalue

Bias Herald agent selection toward a specific topic. Agents with relevant expertise are prioritized in dispatch.

Herald dispatch favors agents matching the focus topic.

$/audit-docs
← Back to Mission Briefing