Topic → the one authoritative doc → the code that implements it. A cold agent should find the right source in a single read instead of ranking entry points. (This router is the repo-level cross-topic pointer that HANDOVER §H6/H9 doesn’t cover, H6/H9 point within a workstream, this points across topics.)
| If you want to know… | Read | Implemented in | Last updated |
|---|---|---|---|
| What Handover is, how to install, trust posture | ../README.md | , | 2026-07-11 |
| The handoff format + the 0–100 rubric + STRUCTURE vs VERIFICATION | ../PROTOCOL.md | bin/lib/handover-doc.js, bin/handover-lint.js |
2026-07-11 |
| Why the product exists, the shape of the bet | PLAN.md | , | 2026-07-08 |
| Archived design history (three-module framing, the behavioral gate, lineage) | ARCHIVE.md | , | 2026-07-14 |
| Current status + the actual next steps (the live handoff) | HANDOFF.md | , | 2026-07-11 |
| What can go stale + the enforcement roadmap | STALENESS.md | bin/handover-lint.js (--repo/--verify) |
2026-07-11 |
| Threat model, review findings, residual risk | SECURITY.md | hooks/gate.js, bin/handover-lint.js, hooks/audit.js |
2026-07-11 |
| Everything that changed, by version | ../CHANGELOG.md | , | 2026-08-01 |
| How to publish this repo (gated checklist, history scrub) | RELEASE.md | , | 2026-08-01 |
| Provisional-patent evaluation, prior art, filing sequencing | IP_EVALUATION.md | , | 2026-08-01 |
| Bench scenarios: how to author one, the empirical-runner contract | ../bench/README.md | bench/run.js |
2026-08-01 |
| How to contribute + the four non-negotiable invariants | ../CONTRIBUTING.md | , | 2026-08-01 |
| Using Handover outside Claude Code (other harnesses, git hook, CI) | PORTING.md | hooks/pre-commit.sample, bin/*.js |
2026-08-01 |
| Area | Files |
|---|---|
| Document validator (pure, deterministic; the STRUCTURE score) | bin/lib/handover-doc.js |
| Lint CLI (STRUCTURE + repo VERIFICATION) | bin/handover-lint.js |
| Scaffold (fills header from live git/gh) | bin/handover-scaffold.js |
| Mutation gate + sticky denials | hooks/gate.js, hooks/lib.js, policy.default.json |
| Loop detector | hooks/loop.js |
| Header gate (PostToolUse) | hooks/handover-gate.js |
| Audit (session + policy provenance) | hooks/audit.js |
| Bench (lint + trap coverage) | bench/run.js, bench/scenarios/* |
| Slash commands | commands/{write,lint,audit}.md |
| Tests | test/run.sh, test/doc.test.js, test/verify.test.sh, test/*.json |
When docs disagree, the one named above for a topic wins; code is truth.