Does this skill work with existing PRDs?

Yes, Ralph Orchestrator has a dedicated PRD mode that reads prd.json files to extract stories, success criteria, and verification methods automatically.

How does Ralph Orchestrator prevent infinite loops?

It builds 'escape hatches' into the prompts, instructing Claude to document blockers, try alternative approaches, or mark tasks as blocked rather than looping indefinitely.

What is a Ralph loop in Claude Code?

A Ralph loop is a self-referential feedback mechanism where Claude iterates on a task using a consistent prompt while maintaining memory through files on disk like progress.md.

Why are progress.md and AGENTS.md important?

Since Claude's prompt is re-fed fresh each iteration, these files act as the AI's long-term memory, storing iteration history, architectural decisions, and current status.

Ralph Orchestrator

Name: Ralph Orchestrator
Author: app-vitals

byapp-vitals

0•

Productivity & Workflow

Automates the creation of structured prompts for iterative Claude Code loops to ensure consistent progress and reliable task completion.

Ralph Orchestrator is a specialized skill for Claude Code designed to scaffold complex development tasks into manageable, high-success iteration loops. It acts as a wrapper for the ralph-loop plugin, providing persistent state management through specialized files like progress.md and AGENTS.md. By converting PRDs or plans into executable prompts with built-in TDD patterns and escape hatches, it allows Claude to maintain context across multiple iterations, preventing infinite loops and ensuring that every step is verified before moving forward.

Key Features

01TDD-based workflow generation for reliable code implementation

02Structured state management using AGENTS.md and project-wide conventions

03Built-in escape hatches to handle blockers and prevent infinite loops

040 GitHub stars

05Automated progress tracking across AI iterations via persistent files

06Multi-mode support for PRDs, project plans, or freeform prompts

Use Cases

01Enforcing Test-Driven Development patterns during AI-led feature development

02Converting a PRD into a sequence of executable, verified coding tasks

03Managing long-running autonomous refactoring loops with state persistence

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add app-vitals/marketplace ralph-orchestrator

For use in Claude.ai and ChatGPT

Download Skill