dev-ralph

Run repeated agent-driven fix attempts until tests pass or circuit breaker triggers.

520|175|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/evolution-foundation/evo-nexus --skill dev-ralph-evolution-foundation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev-ralph
Source: https://github.com/evolution-foundation/evo-nexus/tree/main/.claude/skills/dev-ralph
Command: npx skills add https://github.com/evolution-foundation/evo-nexus --skill dev-ralph-evolution-foundation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Dev Ralph prevents “try once and hope” engineering work by repeatedly running the same agent-driven task with persisted state until a clear completion signal is reached or a circuit breaker halts runaway iterations.

Core Features & Use Cases

  • Persistence loop with state: Re-runs the agent while carrying forward what was tried and why it failed, iteration by iteration.
  • Circuit breaker safety: Stops after 5 iterations or after 3 identical failures to avoid infinite “fix attempts.”
  • Explicit completion criteria: Requires a predefined goal such as tests passing, build green, or a verifier approval, ensuring loops terminate for the right reason.

Use case example: When debugging a flaky or failing CI scenario, Dev Ralph can keep applying targeted fixes while tracking each attempt, then hand off the full state to an escalation agent when completion never arrives.

Quick Start

Use the dev-ralph skill when you have a clear completion signal like “tests pass” and want the agent to iteratively fix the issue while stopping automatically after repeated failure.

Frequently Asked Questions about dev-ralph

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

FAQPage Schema
How do I automate debugging workflows until tests pass without getting stuck in infinite loops?

An iteration-based persistence loop repeatedly runs agent-driven debugging tasks with persisted state until tests pass or a circuit breaker halts the process. It carries forward previous failure context each iteration to avoid repeating mistakes.

How does a circuit breaker prevent runaway agentic loops during automated refactoring?

A circuit breaker stops the agentic loop after 5 iterations or after encountering 3 identical failure fingerprints. This prevents infinite fix attempts and safely halts the workflow when progress stalls.

What completion criteria do I need to set up an agentic loop for software engineering tasks?

You need a predefined completion signal such as tests passing, a green build, or verifier approval. Explicit completion criteria ensure the persistence loop terminates for the right reason rather than stopping arbitrarily.

Can I use state persistence to track repeated debugging attempts for flaky CI scenarios?

Yes, state persistence tracks what was tried and why it failed across each iteration. This allows targeted fixes for flaky CI scenarios and hands off the full state to an escalation agent if completion never arrives.

What happens when the iteration limit is reached but the build verification still fails?

The circuit breaker halts the loop after 5 iterations or 3 identical failures, and the accumulated state from all attempts is preserved. This state can then be handed off to an escalation agent for further analysis.