ralph

Iterates BUILD and verifier checks until PRD stories pass or exceed the blocked-attempt threshold.

2|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/iadr-dev/colab --skill ralph-iadr-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/iadr-dev/colab/tree/main/skills/ralph
Command: npx skills add https://github.com/iadr-dev/colab --skill ralph-iadr-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Ralph solves the problem of AI work stalling or producing unverified outputs by running a disciplined PRD-to-BUILD loop that continues iterating until verification passes or a blocked-attempt limit is reached.

Core Features & Use Cases

  • PRD-loop persistence: Initializes and persists a PRD story state so iterative BUILD continues across the session.
  • Verifier-gated progress: Advances stories only when verifier-aligned evidence succeeds, reducing the chance of premature “done” claims.
  • Blocked-iteration guardrails: Increments attempt counters and hard-stops after repeated blocking to prevent infinite loops.
  • Use Case: When implementing a feature like “auth refresh,” Ralph will keep iterating BUILD, update story status based on verifier results, and move to the next PRD story once the current one is proven.

Quick Start

Activate Ralph by asking the agent to start ralph so it iterates BUILD until the verifier passes or the blocked-attempt limit is reached.

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I keep AI building until verification passes?

To keep AI building until verification passes, use a PRD-driven persistence loop that iterates build and verifier checks until stories pass or exceed the blocked-attempt threshold. Progress is tracked and retried deterministically across the session.

How does verifier-gated progress work in a build loop?

Verifier-gated progress advances stories only when verifier-aligned evidence succeeds, reducing the chance of premature completion claims. The loop increments attempt counters and hard-stops after repeated blocking to prevent infinite iterations.

What is the best way to track multi-story implementation tasks across a session?

Tracking multi-story implementation tasks requires initializing state into per-session PRD JSON. This maintains persistent story status, allowing iterative builds to progress sequentially only when current stories are proven by verifier evidence.

How do I stop an infinite build and test loop?

To stop an infinite build and test loop, blocked-iteration guardrails increment attempt counters and hard-stop after reaching a blocked-attempt limit. You can also trigger user-controlled deactivation via stop commands to halt the workflow.

When do I need PRD-driven persistence for workflow orchestration?

PRD-driven persistence is needed for long-running implementation tasks where progress must be tracked and advanced only on evidence. It ensures the agent continues iterating builds until the verifier passes or the threshold is exceeded.

Does Ralph work without external dependencies?

Yes, Ralph operates without external dependencies, using internal scripts to manage the PRD-to-build loop. It initializes per-session state and handles attempt counters autonomously within your existing environment.