# Which document do you want to keep true?

Find the kind of document you keep, and what goes wrong with it. The tool
links to its card, and each rule or command to its page in the reference of
the release this site pins.

| Document | What goes wrong | Tool | Rule or command |
| --- | --- | --- | --- |
| ADR | The code stops keeping a rule the ADR states; a rule is written so that it can never fail; a code comment cites a decision that was superseded or never written; a superseded ADR still reads as current | [spec-guard](https://spec-family.github.io/tools/index.md#spec-guard), [spec-graph](https://spec-family.github.io/tools/index.md#spec-graph) | [`@assert-*` directives](https://github.com/spec-family/spec-guard/blob/v0.35.0/docs/reference/directives.md) under the sentence, run by `spec-guard`; [`spec-guard prove`](https://github.com/spec-family/spec-guard/blob/v0.35.0/docs/reference/prove.md); [`spec-guard cites`](https://github.com/spec-family/spec-guard/blob/v0.35.0/docs/reference/cites.md); [`live-supersession`](https://github.com/spec-family/spec-graph/blob/v0.26.0/docs/reference/rules.md) |
| Specification | The code stops keeping a rule the specification states; a citation names a document or anchor that is not there; a document rests on a decision since retired; open work is handed to a document that can no longer take it; a claim says `Implemented` and no test stands behind it | [spec-graph](https://spec-family.github.io/tools/index.md#spec-graph), [spec-guard](https://spec-family.github.io/tools/index.md#spec-guard) | [`broken-reference`, `stale-premise`, `ghost-handover`](https://github.com/spec-family/spec-graph/blob/v0.26.0/docs/reference/rules.md); [`@assert-*` directives](https://github.com/spec-family/spec-guard/blob/v0.35.0/docs/reference/directives.md) under the sentence; [`spec-guard claims`](https://github.com/spec-family/spec-guard/blob/v0.35.0/docs/reference/claims.md) |
| Checklist or roadmap | A box is ticked with nothing behind it, cites a claim still open, or names a commit git does not have | [spec-graph](https://spec-family.github.io/tools/index.md#spec-graph) | [`unevidenced-completion`, `premature-completion`, `unknown-commit`](https://github.com/spec-family/spec-graph/blob/v0.26.0/docs/reference/claims-and-evidence.md#checklists-and-ledgers-held-to-what-they-cite) |
| Ledger or status page | A row says done while the claim it cites still leaves work open | [spec-graph](https://spec-family.github.io/tools/index.md#spec-graph) | [`premature-completion`, `unknown-commit`](https://github.com/spec-family/spec-graph/blob/v0.26.0/docs/reference/claims-and-evidence.md#checklists-and-ledgers-held-to-what-they-cite) |
| Register | A row's status is a word the register does not know; a row lacks the resolution, citation or commit its status asks for; two rows share a key | [spec-graph](https://spec-family.github.io/tools/index.md#spec-graph) | [`unknown-register-status`, `incomplete-register-row`, `duplicate-key`](https://github.com/spec-family/spec-graph/blob/v0.26.0/docs/reference/registers.md) |
| Measurement protocol, and the figures that rest on it | A protocol has no method or no dated result; a claim that asks for a measurement cites no protocol; a figure names no record | [spec-graph](https://spec-family.github.io/tools/index.md#spec-graph) | [`incomplete-protocol`, `undated-result`, `target-without-protocol`, `unrecorded-figure`](https://github.com/spec-family/spec-graph/blob/v0.26.0/docs/reference/claims-and-evidence.md#figures-resting-on-a-record) |
| Orientation document: `CLAUDE.md`, `AGENTS.md`, a README | It names a path, a script, a make target or a commit that is not there; the code stops keeping a rule it states | [spec-graph](https://spec-family.github.io/tools/index.md#spec-graph), [spec-guard](https://spec-family.github.io/tools/index.md#spec-guard) | [`missing-path`, `missing-command`](https://github.com/spec-family/spec-graph/blob/v0.26.0/docs/reference/orientation.md), [`unknown-commit`](https://github.com/spec-family/spec-graph/blob/v0.26.0/docs/reference/claims-and-evidence.md#commits-looked-for-in-git); [`@assert-*` directives](https://github.com/spec-family/spec-guard/blob/v0.35.0/docs/reference/directives.md) under the sentence |
| Brief | Its contract is incomplete; two rounds meant to run side by side could write the same file; an agent writes a file the brief protects; the round closes with a protected file changed, a box open, or a claim it raises still open | [spec-brief](https://spec-family.github.io/tools/index.md#spec-brief), [spec-harness](https://spec-family.github.io/tools/index.md#spec-harness) | [`spec-brief lint`, `matrix`, `schedule`, `archive`](https://github.com/spec-family/spec-brief/blob/v0.15.0/docs/reference/commands.md); [`spec-harness guard`](https://github.com/spec-family/spec-harness/blob/v0.26.0/docs/reference/guard.md), [`audit`](https://github.com/spec-family/spec-harness/blob/v0.26.0/docs/reference/audit.md) |

## What each tool reads

spec-graph reads specifications, ADRs and the references between them with
no configuration, including the layouts Spec Kit, OpenSpec and Kiro write
([layouts](https://github.com/spec-family/spec-graph/blob/v0.26.0/docs/reference/sdd-layouts.md)). Its rules for claims,
checklists, ledgers, registers, protocols and orientation documents start
once its configuration names the files that hold them, as `spec-guard claims`
and `spec-guard cites` do; a file no configuration names is not held to them.
The words in the table - claim, label, ledger, register, protocol,
orientation document - are defined in the family's
[concepts](https://github.com/spec-family/spec-core/blob/main/docs/concepts.md).

One tool is a useful install on its own: spec-guard alone holds code to what
its Markdown says, and spec-graph alone holds documents to each other and to
the record they cite. [Adopting](https://github.com/spec-family/spec-core/blob/main/docs/adopting.md) goes from one
tool to the whole loop, and the overview's
[problem-by-problem table](https://github.com/spec-family/spec-core/blob/main/docs/overview.md#which-problem-which-tool) names the
command for each problem.

---

This is the Markdown version of https://spec-family.github.io/documents/. Every command's output in it is printed by spec-brief 0.15.0, spec-graph 0.26.0, spec-guard 0.35.0 and spec-harness 0.26.0 in the site's CI; [llms.txt](https://spec-family.github.io/llms.txt) lists every page.
