fidelity-auditor
Cold WHAT-conformance acceptance audit at a stage-PR boundary. Given ONLY the kickoff/spec (or a scoped section of it) and the 3-dot diff — NEVER the chat, the design dialogue, or the implementation log — judges whether the diff is what the kickoff asked for.
fidelity-auditor
Status: shipped-beta · Ships to: npm lane — delivered into the consumer's .claude/agents/ by the setup delivery loop (setup.d/20-agents.sh:24) · Fires at: dispatched as a Claude Code sub-agent (frontmatter name:; the session's agent list carries its one-line description)
What it is
"> Authoritative for: the fidelity-audit protocol — inputs, question, output grammar." (agents/fidelity-auditor.md:19). Class B detection layer of the acceptance contour: "> Class: B — the named cold-agent detection layer of the acceptance contour" with "> the fail-closed transport is the pr-body-fidelity CI gate" (agents/fidelity-auditor.md:11-14). Fires "> Fires: at every stage-PR boundary — /harvest §4 fidelity step, /dispatcher §2.4" pre-egress gate, night-mode PR-gate (agents/fidelity-auditor.md:17-18). One question: "is this diff WHAT the" kickoff asked for (agents/fidelity-auditor.md:35-36) — design altitude only, never code quality.
How it works
- "## Role — cold by construction" (line 32): "You are a COLD design-altitude acceptance auditor. You never saw the design dialogue or the" implementation session (
agents/fidelity-auditor.md:34). - "## Inputs (paths/text only — never chat context, never implementation logs)" (line 45): "1. The kickoff/spec path (the sole statement of intent — if something was agreed but is not in" that file, it cannot know it (line 47); the full 3-dot diff (line 51); audited SHA + round (line 52).
- "## Protocol" (line 54): read the kickoff fully — "1. Read the kickoff/spec fully. Extract the deliverables list, the declared descopes" (line 56); map every deliverable to diff evidence (line 58); "3. Report three drift lists, each entry with file:line evidence:" (line 59) — missing / "extra — present in the diff, not asked (scope creep; check the kickoff's out-of-scope" (line 61) / diverged; ambiguous kickoffs get flagged not graded (line 64).
- "## Output grammar (mandatory, machine-consumed)" (line 73): "FIDELITY: GO | REVISE | STOP" (line 76); "Verdict rule: any BLOCKER → STOP. Any MAJOR missing/diverged → REVISE. Only MINOR or clean →" GO (line 87); single-block invariant — "The PR body carries exactly ONE"
## Fidelity verdictsection, rework replaces, never appends (lines 100-104). - "Severity contract (reviewer-discipline.md §6):" gates which findings may trigger a round (line 91).
Satellites & companions
- USES: the pr-body-fidelity gate as transport (line 13) and reviewer-discipline §6 severity contract + §6.1 triage rubric (lines 91, 98).
- ADAPTS: the GO/REVISE/STOP vocabulary — line 30: "> vocabulary** per dispatch-input-checker.md §Output grammar alignment.".
- ADDS: the machine-consumed FIDELITY verdict block and the Watch-list: "Every round emits a
### Watch-listsub-block below the verdict, including on GO: on GO" the items are what a later round must not undo (line 113). - Census family satellites: peer cold auditors C7 (docplan-auditor — PR-blind vs this agent's dialogue-blind contract) and C5 (claims-conformance-auditor).
Anchors
agents/fidelity-auditor.md:2—name: fidelity-auditoragents/fidelity-auditor.md:3—description: Cold WHAT-conformance acceptance audit at a stage-PR boundary. Given ONLY the kickoff/spec (or a scoped section of it) and the 3-dot diff …agents/fidelity-auditor.md:19—> **Authoritative for:** the fidelity-audit protocol — inputs, question, output grammar.agents/fidelity-auditor.md:32—## Role — cold by constructionagents/fidelity-auditor.md:45—## Inputs (paths/text only — never chat context, never implementation logs)agents/fidelity-auditor.md:59—3. Report three drift lists, each entry with file:line evidence:agents/fidelity-auditor.md:76—FIDELITY: GO | REVISE | STOPagents/fidelity-auditor.md:87—Verdict rule: any BLOCKER → STOP. Any MAJOR missing/diverged → REVISE. Only MINOR or clean →agents/fidelity-auditor.md:100—**Single-block invariant (enforced by the gate).** The PR body carries exactly ONEagents/fidelity-auditor.md:113—Every round emits a### Watch-listsub-block below the verdict, **including on GO**: on GOsetup.d/20-agents.sh:24—for f in "$PKG_ROOT"/agents/*.md; do
All anchors at framework pin b069c59328aa8e08671d3a19fd25efa618dfc1c5 (fetched 2026-09-11 from artyhoo/getff staging; ancestry of census pin a1337cb301 verified).
docplan-auditor
Cold semantic-grouping judgment for a DocPlan. Given ONLY the DocPlan (its sections + excluded[]) and the ConventionNodes it references — NEVER the diff, the PR body, or the rendered AGENTS.md region — judges whether each section's title coheres with its member nodes, flags mis-grouped nodes, checks exclusion reasons are substantive, and assesses section granularity.
living-docs-auditor
Runs scripts/audit-ai-docs.sh and reports findings. Catches backward Living-Documentation drift — whether AGENTS.md/RULES.md rules still hold in the actual code. Reports; does not fix.