Skills

Ralph

Self-referential loop until task completion with configurable verification reviewer

Install

npx skills add Yeachan-Heo/oh-my-claudecode --skill ralph -g -a claude-code -y
Category
Engineering
Updated
3d ago
License
MIT
Context cost
Mediumabout 3,000 tokens
Runs scripts
No, instructions only

What it does

Self-referential loop until task completion with configurable verification reviewer

[RALPH - ITERATION {{ITERATION}}/{{MAX}}]

Your previous attempt did not output the completion promise. Continue working on the task.

<Purpose> Ralph is a PRD-driven persistence loop that keeps working on a task until ALL user stories in prd.json have passes: true and are reviewer-verified. It combines session persistence, automatic retry on failure, structured story tracking, and mandatory verification before completion. </Purpose> <Precondition_Feedback_Gate> NON-NEGOTIABLE, runs before any story work and at every verification gate:
  1. FIRST ITERATION, before picking a story: run omc ralph verify --write-baseline --session <sessionId> (session id: read OMC_SESSION_ID if set, omc ralph afk exports it, else the one in the Ralph continuation context / active PRD path; use the SAME id for every call in this run). This records the feedback baseline. If the command is unavailable or denied, STOP and report the failure, do not fall back to hand-rolled judgment.
  2. EVERY verification gate (story verification, post-deslop re-verification): run omc ralph verify --session <sessionId> and obey the exit code, 0 = pass (baseline-only failures are recorded warnings, never a story failure), 1 = new failures to fix.
  3. NEVER hand-roll the feedback diff (running the suite yourself and eyeballing the output is exactly the failure mode this gate exists to prevent). </Precondition_Feedback_Gate>

<Use_When>

  • Task requires guaranteed completion with verification (not just "do your best")
  • User says "ralph", "don't stop", "must complete", "finish this", or "keep going until done"
  • Work may span multiple iterations and needs persistence across retries
  • Task benefits from structured PRD-driven execution with reviewer sign-off </Use_When>

<Do_Not_Use_When>

Read the whole SKILL.md on GitHub

More in Engineering