---
name: polygraph
description: /polygraph <target> — dispatch the polygraph agent on a doc, feature, folder, code path, or plan. User-invoked only; the model never loads this on its own.
disable-model-invocation: true
---

# /polygraph — the user's door to the audit

The docs-truth audit is the **`polygraph` agent** (`.claude/agents/polygraph.md` in a consumer repo, `agents/polygraph.md` in etna), and it runs only when the user asks. This command is that ask, made explicit: `/polygraph docs/features/billing.md`, `/polygraph billing`, `/polygraph docs/architecture/`, `/polygraph src/billing/`, or `/polygraph docs/history/plans/2026-09-01-billing.md`.

1. **Dispatch the `polygraph` agent** with the argument as its target, word for word. No argument ⇒ ask for one and dispatch nothing.
2. **Relay its report** to the user as it came — the counts, the corrections, the register rows, and every open question in full. Its questions are the user's to answer; never answer them yourself, and never fold an unanswered question into a doc edit.
3. **An answer goes back as a further dispatch** to the same agent — the row id, the question, and the user's words verbatim — and its report closes the loop.

This folder also carries what the agent reads and runs, so it ships wherever the agent does:

| Path | Read by |
| --- | --- |
| `references/rows.md` | the agent — the ten-field row, the seven verdicts, the residue guard, frozen records, a document's right to exist |
| `references/dispatch.md` | the agent — the run folder, the context pack, the three roles, packets, verification, fold-back, recovery, price |
| `scripts/audit.mjs` | the agent — the read-only arithmetic over a run folder |
| `evals/` | authoring time only; never shipped |