What problem does it solve?
Ralph ensures complex, multi-iteration tasks do not end prematurely by persisting progress and iterating until every PRD user story passes verified acceptance criteria, preventing silent failures, skipped tests, and scope reduction.
Core Features & Use Cases
- PRD-driven persistence: Auto-generates or reads prd.json, breaks work into verifiable user stories, and tracks progress in progress.txt across iterations.
- Automated verification loop: Runs parallel agent work, executes tests/builds, enforces reviewer verification, performs an optional cleanup pass (ai-slop-cleaner), and re-runs regression checks before marking completion.
- Use case: Use Ralph when a feature or bugfix must be demonstrably complete with passing tests and an explicit reviewer sign-off, such as security fixes, critical integration work, or multi-module refactors.
Quick Start
Invoke the assistant with a natural command like: ralph complete the authentication module with PRD enforcement --critic=architect