ratchetlisted

# Ratchet Skill Track progress through the RPI workflow with permanent gates. **Note:** `$ratchet` tracks and locks progress. It does not “run the loop” by itself—pair it with `$crank` (epic loop) or `$swarm` (Ralph loop) to actually execute work. ## The Brownian Ratchet ``` Progress = Chaos × Filter → Ratchet ``` | Phase | What Happens | |-------|--------------| | **Chaos** | Multiple attempts (exploration, implementation) | | **Filter** | Validation gates (tests, $vibe, review) | | **Ratchet** | Lock progress permanently (merged, closed, stored) | **Key insight:** Progress is permanent. You can't un-ratchet. ## Execution Steps Given `$ratchet [command]`: ### status - Check Current State ```bash ao ratchet status 2>/dev/null ``` Or check the chain manually: ```bash cat .agents/ao/chain.jsonl 2>/dev/null | tail -10 ``` ### check [step] - Verify Gate ```bash ao ratchet check <step> 2>/dev/null ``` Steps: `research`, `plan`, `implement`, `vibe`, `post-mortem` ### record [step] - Record Completion ```bash ao ratchet record <step> --output "<artifact-path>" 2>/dev/null ``` Or record manually by writing to chain: ```bash echo '{"step":"<step>","status":"completed","output":"<path>","time":"<ISO-timestamp>"}' >> .agents/ao/chain.jsonl ``` ### skip [step] - Skip Intentionally ```bash ao ratchet skip <step> --reason "<why>" 2>/dev/null ``` ## Workflow Steps | Step | Gate | Output | |------|------|--------| | `research` | Research artifact exists | `.agents/resear