← ClaudeAtlas

handoverlisted

Make the project fully transferable to another human or agent with zero verbal context. Use at milestones, before breaks, when a new person/tool joins, or when the owner asks "can someone else take this over?". Also the end-of-session discipline when significant work happened.
Tradebaas/Groundwork · ★ 2 · AI & Automation · score 71
Install: claude install-skill Tradebaas/Groundwork
# handover: the repo must speak for itself The test is always the same: **a competent stranger, any IDE, any model, gets only the repo. Can they continue within ten minutes?** If anything requires this conversation, your memory, or files outside the repo, the handover is broken. ## The audit Walk it as the stranger would: 1. `README.md` → do the copy/start instructions still hold for this project? 2. `AGENTS.md` routing table → does every row point at a file that exists and is current? 3. `docs/state/STATE.md` handoff block → status, phase, branch, gates, Now ▶, blockers. Is it literally true *right now*? Stale handoff is the most damaging lie in the system. 4. `docs/product/BRIEF.md` → does it still describe the product that exists? 5. Can the stranger run it? Setup steps, env vars (`.env.example` complete?), seed data, `docs/operations/` runbooks. Follow them literally; fix what's wrong, don't annotate around it. A fresh clone must also re-run `node checks/check.mjs --install-hooks`. Is that step where the stranger will see it (README/setup)? 6. Secrets and access: nothing secret in the repo, and a named list of what access a successor must be granted (where credentials live, who grants them) in `docs/operations/access.md`. 7. Open threads: in-flight specs at their real status; INTAKE triaged or explicitly queued; DEBT.md reconciled with `defer:` markers. Fix everything fixable now. What you can't fix, write down as an explicit gap in STATE.md. A name