ralph

Execute multi-phase tasks through iterative verification and planner approval.

3|Updated Nov 30, 2025
One-click install
npx skills add https://github.com/alpoxdev/claude-code --skill ralph-alpoxdev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/alpoxdev/claude-code/tree/main/.claude/skills/ralph
Command: npx skills add https://github.com/alpoxdev/claude-code --skill ralph-alpoxdev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Ralph skill provides an autonomous, infinite-loop approach for solving highly complex, multi-phase tasks by enforcing evidence-based progress checks and requiring planner approval before signaling completion.

Core Features & Use Cases

  • Phase-driven execution: Phase 1 (implementation), Phase 2 (verification), Phase 3 (planner validation), Phase 4 (completion).
  • Fresh iteration verification: each loop performs new checks (/pre-deploy, TaskList, Planner response) without reusing prior results.
  • Multi-agent orchestration: parallel execution of implementation, design, documentation tasks, with synchronized status updates.
  • Session persistence for recovery: tracks progress in .claude/ralph/00.[task-name]/ with TASKS.md, PROCESS.md, VERIFICATION.md, ITERATION.md.

Quick Start

To start, invoke Ralph on a new task; the system reads the prompt, creates a session folder, launches Phase 1 agents in parallel, and proceeds through the loop to produce a final <promise> only after all phases succeed.

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I automate multi-agent task verification until planner approval?

Multi-agent task verification is automated through an evidence-driven, self-improving loop that advances execution from implementation to completion, requiring fresh validation checks and planner approval before reporting success.

What is phase-based execution for multi-agent orchestration?

Phase-based execution divides complex tasks into four stages: implementation, verification, planner validation, and completion, launching parallel agents and performing fresh iteration checks to ensure evidence-based progress.

How do I set up iterative task tracking for complex multi-phase projects?

Iterative task tracking is set up by invoking the skill on a new task, which creates a session folder tracking progress across TASKS.md, PROCESS.md, VERIFICATION.md, and ITERATION.md files for session persistence and recovery.

Can I use parallel execution for implementation and documentation tasks?

Parallel execution supports implementation, design, and documentation tasks simultaneously within multi-agent orchestration, providing synchronized status updates across all active agents during the phase-driven loop.

What's the best way to enforce fresh validation checks every iteration loop?

Fresh validation is enforced by performing new checks during each loop iteration using pre-deploy verification, task list tracking, and planner response evaluation, explicitly preventing the reuse of prior validation results.

When should I not use an infinite-loop approach for task completion?

An infinite-loop task completion approach should be avoided for simple, single-phase tasks that do not require parallel multi-agent orchestration, automated verification, or explicit planner approval gates before finishing.