What problem does it solve?
It prevents incomplete work by forcing every proposed deliverable to be independently verified against an agreed Definition of Done.
Core Features & Use Cases
- DoD-first workflow: turns the user’s intent into 3–7 concrete, binary, verifiable completion criteria before any work starts.
- User-confirmed iteration loop: uses interactive confirmation (AskUserQuestion) and a max-iteration circuit breaker to avoid endless cycling.
- Stop-hook verification with re-injection: blocks exit when any DoD items remain unchecked and reinjects the original prompt with remaining checklist items for targeted fixes.
- Separated verification context: runs a dedicated verifier agent to objectively mark checklist items as pass/fail based on actual files/tests.
Use case: when implementing a feature (or fixing a bug), you agree on verifiable completion checks up front (tests, expected files/functions, no type/lint errors), and the loop ensures each check is satisfied before the session can end.
Quick Start
Invoke ralph to iterate until all Definition of Done criteria are independently verified, starting with your request and accepting or editing the proposed DoD.