ralph-loop

Files (1)

• SKILL.md

SKILL.md (first lines)

# 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.

From tainn03/oh-my-copilot, MIT.

More from tainn03/oh-my-copilot