prp-ralph-loop

Automated plan execution requires a persistent state file to orchestrate iterative cycles, running type-check, lint, test, and build validations until all tasks complete and pass. This enforces deterministic iteration behavior across multiple loops.

A Ralph loop iteration is an operational protocol for autonomous plan execution that reads a state file, interprets the plan, executes validations, and logs progress across multiple cycles until a final completion condition is met.

To run autonomous iterations, initialize a state file using the controlling tool to begin iterative execution. The loop progresses through plan execution, validation enforcement, and progress updates until all validations pass and tasks are completed.

Yes, this protocol is designed for autonomous execution in PRP projects. It requires a state file to exist and enforces strict validation execution and progress logging, ensuring deterministic iteration behavior without manual intervention.

Maintain state and learnings across cycles by using a persistent state file that tracks progress and logs structured learnings. This informs future iterations and supports pattern discovery throughout the execution loops.

An iteration loop may stall if the state file is missing or if validations such as type-check, lint, tests, or build fail. The loop requires reading the state, interpreting the plan, and passing all validations before the final completion condition triggers.