ralph-workflow

Enforce per-loop execution contracts with RALPH_STATUS blocks for the Ralph workflow.

1|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/wtthornton/tapps-brain --skill ralph-workflow-wtthornton
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-workflow
Source: https://github.com/wtthornton/tapps-brain/tree/main/.claude/skills/ralph-workflow
Command: npx skills add https://github.com/wtthornton/tapps-brain --skill ralph-workflow-wtthornton

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ralph's per-loop execution contract ensures progress is observable by the harness, preventing silent, partial, or regressive work by requiring a valid ---RALPH_STATUS--- block after each loop invocation and by gating advancement when the contract isn't satisfied.

Core Features & Use Cases

  • Enforces a repeatable per-loop procedure: read fix_plan.md, pick the first unchecked task, report completion in the RALPH_STATUS block, and decide if the epic boundary QA is needed.
  • Automates progress signaling and gating: tracks completion indicators, trips the circuit breaker on no-progress loops, and exits when EXIT_SIGNAL is true with adequate completion indicators.
  • Supports end-to-end loop hygiene: ensures compliance for per-loop QA, deslop (epic) flows, and safe termination of the loop.

Quick Start

Invoke the Ralph workflow at the start of every loop so the response includes a compliant ---RALPH_STATUS--- block.

Frequently Asked Questions about ralph-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce observable progress in an automated loop workflow?

Observable progress in an automated loop workflow is enforced by requiring a valid ---RALPH_STATUS--- block after each invocation. This contract prevents silent or regressive work by gating advancement until valid status is reported.

What is the best way to gate advancement and track completion in a loop harness?

Gating advancement and tracking completion in a loop harness is managed by tripping a circuit breaker on no-progress loops. It exits safely when EXIT_SIGNAL is true and adequate completion indicators are met.

How does the RALPH_STATUS block ensure safe loop termination?

The RALPH_STATUS block ensures safe loop termination by emitting a properly structured status report that tracks completion indicators and evaluates the EXIT_SIGNAL. This prevents partial execution from ending the loop prematurely.

When do I need to trigger QA checks in a per-loop execution contract?

QA checks in a per-loop execution contract are triggered when the loop reaches an epic boundary. The workflow reads fix_plan.md, reports task completion, and decides if the epic boundary QA is needed for loop hygiene.

Why does my loop workflow fail to advance to the next task?

Loop workflow advancement fails when the per-loop execution contract is not satisfied. The harness requires a compliant ---RALPH_STATUS--- block to report completion and verify progress before picking the next unchecked task.

Can I use this workflow to automate reading fix_plan.md and reporting completion?

Yes, you can automate reading fix_plan.md and reporting completion by invoking the Ralph workflow at the start of every loop. It picks the first unchecked task and outputs a compliant ---RALPH_STATUS--- block.