planlisted

# compass:plan Convert `contract.md` into the plan the world's best engineers would deliver right the first time. ## Step 0 — gate Run `compass.sh gate .claude/builds/<slug> review-contract`. **Non-zero → STOP** (contract not LOCKED), offer `compass:review-contract`. Read `contract.md` — the invariant below. ## ⛔ Phase 0 — understand the codebase FIRST (write findings INTO the plan; cite real paths) 1. **Repo guidance + tooling** (PREFER existing workflows): `CLAUDE.md`, `.claude/`, architecture/invariants docs, CI, package scripts, Makefile, test/migration/seed/perf/OOM scripts, deploy hooks. 2. **Real blast radius** — read the *actual* code for every area the contract touches; name files, readers/writers, routes, jobs, DB tables, and the **existing workflows that depend on them** (direct + indirect) that could regress. **Rewrite the INDEX `touches` line with this real file list**, and if it overlaps another in-flight build, surface it and ask. 3. **Real infra constraints** — DB plan/size, instances, caching, memory ceiling, RBAC, cost invariants. Read, don't assume. 4. **Confirm reconciliation against reality** — can the reproducing query recompute toward the pinned gold? If not, surface it (the contract may bounce back). **Greenfield:** no code → inventory the chosen stack/scaffolding/conventions/tooling and say "greenfield." ## The plan (`plan.md`) 1. **Traceability** — every contract requirement → step(s). 2. **INVARIANT → assertion map** — each INVARIANT → the exact