afrizzal/ratchet
6 stars · Last commit 2026-07-10
resumable engineering loops for Claude Code — audit a codebase into an acceptance-gated backlog, then execute it one verified commit at a time.
README preview
# ⚙️ Ratchet **Verified, resumable engineering loops for Claude Code.** A ratchet only turns forward. Every unit of work is gated by acceptance criteria and locked in as one atomic commit — the loop never slides back, never wanders off-spec, and never loses its place. > Point it at a codebase → get a reviewable backlog → let the loop work through it, one verified commit at a time. Walk away. Come back to a ledger of what shipped, what's blocked, and what needs *you*. --- ## Why Agentic coding is great at bursts and terrible at campaigns: - **State lives in the context window.** Kill the session and the plan dies with it. - **"Done" is vibes.** The agent says *fixed*; nothing proved it. - **Scope creeps.** One fix becomes a refactor becomes a mess. - **Autonomy is all-or-nothing.** Either you babysit every step, or you hand over the keys and pray. Ratchet's answer is one structural move: **the loop's entire state lives in a markdown file** — `BACKLOG.md` — that is git-tracked, human-readable, and human-editable. The agent is stateless; the file is the state.