ralph-loop - Completion Enforcement Loop

When to use this skill

• Long-running implementation tasks that tend to stop early
• Tasks that need strict completion signaling
• Workflows using

  ultrawork

  /

  ulw

  in OpenCode
• Sessions where the agent must continue until exact completion

1. Core Command Pattern

/ralph-loop "<task description>" [--completion-promise=TEXT] [--max-iterations=N]

• Completion promise:

  DONE

• Max iterations:

  100

2. How the Loop Behaves

1. Starts with your task prompt.
2. On each idle cycle, verifies whether the assistant output contains:

<promise>DONE</promise>

1. If not found, injects a continuation prompt and increments iteration.
2. Stops only when:
   • Completion promise is detected, or
   • Max iterations is reached, or
   • You run

     /cancel-ralph

     .

3. Practical Usage

Standard run

/ralph-loop "Refactor auth module and finish all tests"

Custom promise

/ralph-loop "Migrate API clients to v2" --completion-promise=SHIP_IT

Bounded iteration run

/ralph-loop "Fix flaky CI tests" --max-iterations=20

Cancel active loop

/cancel-ralph

4. Integration Notes for skills-template

• Keep this skill as an operational guide for OpenCode workflows.
• Pair with orchestration skills (for example,

  ohmg

  ) when tasks require delegation.
• Require explicit completion tags in final responses to avoid premature stop.

Quick Reference

/ralph-loop "task"

/ralph-loop "task" --completion-promise=TEXT

/ralph-loop "task" --max-iterations=N

/cancel-ralph