ralph-loop

name	ralph-loop
description	Self-referential development loop that runs until task completion. Includes Ralph Loop (basic), ULW Loop (with Oracle verification), and cancel-ralph functionality.

Ralph Loop

A self-referential development loop that runs until task completion.

Variants

Ralph Loop (Basic)

1. Work on the task continuously
2. When the task is FULLY complete, output: <promise>DONE</promise>
3. If you don't output the promise, continue working
4. Maximum iterations: 100 (configurable)

ULW Loop (Ultrawork)

1. Work on the task continuously
2. When the work is complete, output: <promise>DONE</promise>
3. That does NOT finish the loop yet - Oracle verification is required
4. The loop only ends after Oracle verifies the result
5. There is no iteration limit

Rules

• Focus on completing the task fully, not partially
• Don't output the completion promise until the task is truly done
• Each iteration should make meaningful progress toward the goal
• If stuck, try different approaches
• Use todos to track your progress

Exit Conditions

Ralph Loop

1. Completion: Output your completion promise tag when fully complete
2. Max Iterations: Loop stops automatically at limit
3. Cancel: User says "cancel ralph" or "stop"

ULW Loop

1. Verified Completion: Oracle verifies the result
2. Cancel: User says "cancel ralph" or "stop"

Usage

ralph-loop "task description" [--completion-promise=TEXT] [--max-iterations=N]
ulw-loop "task description" [--completion-promise=TEXT]

Default completion promise is "DONE" and default max iterations is 100.

Cancel

To cancel an active loop:

1. Stop the loop from continuing
2. Clear the loop state
3. Allow the session to end normally

Check if a loop is active and cancel it. Inform the user of the result.

Your Task

Parse the arguments and begin working. Work continuously until the task is fully complete, then output the completion promise.