Ralph Loop

Trigger

The user wants to start a Ralph loop. An iterative development loop where the same prompt is fed back after every turn, and the agent sees its own previous work each iteration.

Workflow

1. Gather the user's task prompt and optional parameters:

   • max_iterations (number, default 0 for unlimited)
   • completion_promise (text, or "null" if not set)

2. Create the directory .cursor/ralph/ if it doesn't exist, then write the state file at .cursor/ralph/scratchpad.md with this exact format:

   ---
   iteration: 1
   max_iterations: <N or 0>
   completion_promise: "<TEXT>" or null