What problem does it solve?
Ralph prevents incomplete or falsely “finished” work by enforcing a PRD-driven, story-by-story loop that only declares completion after explicit reviewer verification.
Core Features & Use Cases
- PRD-driven persistence loop: Breaks work into user stories backed by verifiable acceptance criteria in prd.json and keeps iterating until all stories pass.
- Evidence-based verification: Re-checks each story’s acceptance criteria and requires reviewer sign-off (architect/critic/codex).
- Automatic retry and progress tracking: Persists iteration progress in progress.txt and continues across retries until completion is truly met.
- Mandatory post-approval cleanup: Runs an ai-slop-cleaner pass on only the session’s changed files, then re-runs regression checks.
Quick Start
Ask your Claude Code agent to run ralph on your task, optionally adding a verifier choice like --critic=architect.