The runnable claim-governance kit distilled from the FrankenSuite research program: a 28-item two-phase checklist, machine-checkers, and a pre-commit honesty gate, in plain Markdown and POSIX shell with zero dependencies. Everything below is a direct download of a shipped kit file.
Section map. This page ships the 28-item two-phase kit only. Phase C (the 14 vendor-port rigor gates) and the G1 through G14 checkers are not in this zip: no gates directory and none of the checker scripts ship under starter-kit/scripts, and the gated kit lands in the version after the completion marker. The gate reference table is cited by path at ecosystem/pickup/_s0/g1-g14-reference.md, not copied here.
Phase A — Planning: is the plan execution-ready? Before agents are set free, the plan must be complete, reviewed, and machine-checked. Items A1–A14 of CHECKLIST.md. The planning packet (templates/planning-packet.md) is the contract; scripts/check-readiness.sh is the machine that checks it. Missing any field means NOT READY.
Phase B — Beads/execution: is execution staying honest? Once work starts, the beads graph is the executable form of the plan and the honesty machinery runs continuously: claim discipline, the negative-evidence ledger, demotion rules, and a pre-commit hook that proves its own teeth. Items B1–B14.
The phase boundary is the execution sign-off (A14, packet section 12). No agent executes an unsigned packet. (starter-kit/README.md)
sh scripts/init.sh /path/to/my-project
This creates the folder layout, evidence ledgers, the 28 seeded checklist
beads, the honesty pre-commit hook, and the CI backstop workflow. Set your
git identity first, or the first commit fails.
POSIX sh only; git is optional but strongly recommended.
./scripts/check-readiness.sh
Exit 0 means READY. A pristine template reports NOT READY by design:
guidance lines never count as content, so only real prose satisfies a section.
git add -A && git commit -m "chore: initialize with starter kit"Local gates are advisory; templates/kit-gates.yml re-runs every gate in CI, where git commit --no-verify cannot reach.
Full 8-step walkthrough lives in the kit's README (link below). The kit deliberately does not create a README.md for your project: write it last, once at least one claim is enforced with a real proof (checklist item B6).
Snapshot, 2026-09-22: the files below are the validated kit as of 2026-09-22 (28 items, two phases). The 14 vendor-port rigor gates (Phase C) are in final grading and ship with the next version.
Every shipped file, one line on what it does. Links are relative, so they work from a plain static host or a local file copy.
| File | What it does |
|---|---|
| Documents | |
| README.md | The kit's front door: two-phase model, 8-step quickstart, file map, design principles. |
| CHECKLIST.md | The 28-item two-phase checklist (A1–A14 planning, B1–B14 execution); every item carries id, what/why, observable done criteria, verification method, origin, and class. |
| REFERENCES.md | Provenance map: every mechanism traced to its originating repo and exact file path; what was borrowed and what was changed. |
| Scripts (POSIX shell, zero dependencies) | |
| scripts/init.sh | The single starting command: builds the project layout, ledgers, seeded beads, hook, and CI workflow. Safe to re-run; never overwrites existing files. |
| scripts/check-readiness.sh | Machine-checks the planning packet for section presence, substance signals, and required vocabulary. Missing field means NOT READY; exit 0 is READY. |
| scripts/check-claim-discipline.sh | Cross-checks README claims against proof artifacts: every enforced row must match README prose exactly and resolve to a real proof file. |
| scripts/checklist2beads.awk | Converts CHECKLIST.md into the beads JSONL seed (init.sh uses it); each checklist item becomes one open bead with acceptance criteria. |
| scripts/hooks/pre-commit | The honesty gate git executes on every commit: self-tests with a canary false claim, runs the claim-discipline checker, and fails closed if the checker is missing. Bypassed only by --no-verify, which is why CI re-runs the gates. |
| Templates (read-only reference copies; edit the installed working copies) | |
| templates/planning-packet.md | The 12-section planning packet contract with machine-checkable markers () that check-readiness.sh keys on. |
| templates/claims.tsv | The claim registry schema: one row per claim, with readme_pattern, proof artifact, and enforce flag. |
| templates/agents.md | Agent operating instructions carrying the 12 forbidden reward-hacking patterns and the three load-bearing rules. |
| templates/definition-of-done.md | The Definition of Done: done and blocked are states with evidence (command output, updated docs), not status updates. |
| templates/kit-gates.yml | CI workflow template that re-runs the readiness and claim-discipline gates on every push; the backstop --no-verify cannot reach. Includes commented toolchain steps to fill per language. |
| templates/negative-evidence-entry.md | Ledger row schema for falsified hypotheses and dead ends, with one filled real-suite example, so the next agent does not relitigate what was disproved. |
| templates/bead-schema.md | Bead field schema for the JSONL fallback: one JSON object per line, close_reason structural so prose-closed beads cannot hide. |
| templates/demotion-rules.md | Starter demotion rules moving claims down when evidence weakens, each marked mechanical or procedural. |
Executable beats prose. The beads graph is the plan; documents are the rationale of record.
Mechanical where cheap, doctrine where judgment lives. Four checklist items are enforced by scripts; the rest are conventions with named verifiers. The kit never pretends a script exists where the suite only had a habit.
Local gates are advisory; CI is the backstop. git commit --no-verify bypasses the pre-commit hook by git's design. The kit names the hatch instead of hiding it (CHECKLIST.md B5).
Nothing invented. Every checklist item and template field traces to observed suite evidence; thin evidence is marked PROVISIONAL, not hidden.
Gates must have teeth. The hook fails a canary false claim before it checks anything real, and fails closed if its checker is missing. A gate that cannot fail is decoration.