Ratchet
ProductivityratchetRatchet is an Agent Skill for productivity published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Brownian Ratchet progress gates for RPI workflow. Check, record, verify. Triggers: "check gate", "verify progress", "ratchet status".
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/data/ratchet/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/ratchet, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Ratchet Skill
Track progress through the RPI workflow with permanent gates.
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
ao ratchet status 2>/dev/null
Or check the chain manually:
cat .agents/ao/chain.jsonl 2>/dev/null | tail -10
check [step] - Verify Gate
ao ratchet check <step> 2>/dev/null
Steps: research, plan, implement, vibe, post-mortem
record [step] - Record Completion
ao ratchet record <step> --output "<artifact-path>" 2>/dev/null
Or record manually by writing to chain:
echo '{"step":"<step>","status":"completed","output":"<path>","time":"<ISO-timestamp>"}' >> .agents/ao/chain.jsonl
skip [step] - Skip Intentionally
ao ratchet skip <step> --reason "<why>" 2>/dev/null
Workflow Steps
| Step | Gate | Output |
|---|---|---|
research | Research artifact exists | .agents/research/*.md |
plan | Plan artifact exists | .agents/plans/*.md |
implement | Code + tests pass | Source files |
vibe | /vibe passes | .agents/vibe/*.md |
post-mortem | Learnings extracted | .agents/retros/*.md |
Chain Storage
Progress stored in .agents/ao/chain.jsonl:
{"step":"research","status":"completed","output":".agents/research/auth.md","time":"2026-01-25T10:00:00Z"}
{"step":"plan","status":"completed","output":".agents/plans/auth-plan.md","time":"2026-01-25T11:00:00Z"}
{"step":"implement","status":"in_progress","time":"2026-01-25T12:00:00Z"}
Key Rules
- Progress is permanent - can't un-ratchet
- Gates must pass - validate before proceeding
- Record everything - maintain the chain
- Skip explicitly - document why if skipping a step