ralph-pipeline

Chains 9 planning and execution phases with context isolation in Claude Code.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/vnnkl/ralph-pipeline --skill ralph-pipeline
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-pipeline
Source: https://github.com/vnnkl/ralph-pipeline/tree/main
Command: npx skills add https://github.com/vnnkl/ralph-pipeline --skill ralph-pipeline

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Orchestrates the full Ralph Loop workflow from idea to shipped, reviewed, harvested code by chaining 9 phases with context isolation and /clear between phases.

Core Features & Use Cases

  • End-to-end orchestration: chains planning, research, PRD generation, execution, review, and harvest with automatic state persistence across phases.
  • Context isolation: each phase runs in a fresh Claude session to prevent context bleed and preserve decisions.
  • Bead generation & execution readiness: converts PRD into beads and coordinates headless or manual execution with gates.
  • Marathon mode (v1.1): plan-all-then-execute flow with a merged bead queue and bead inventory gate.
  • Codemaps integration: shares codebase context with agents via codemaps and refreshes post-execution for review.

Quick Start

Run the pipeline and answer prompts to guide the run.

Frequently Asked Questions about ralph-pipeline

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

FAQPage Schema
How do I orchestrate multi-phase development workflows with context isolation in Claude Code?

Multi-phase orchestration with context isolation runs each planning and execution step in a fresh Claude session, preventing context bleed while maintaining state on disk. Ralph Pipeline chains 9 phases end-to-end, loading phases 1-7 with a fresh context per phase to preserve decisions.

How does bead generation work for converting PRDs into execution queues?

Bead generation converts a PRD into a structured bead queue ready for execution. Ralph Pipeline coordinates this conversion process, supporting both headless and manual execution with interactive gates to control the flow of beads through the pipeline.

Can I run an entire feature journey from planning to code review without manual intervention?

Yes, YOLO mode enables automated end-to-end orchestration from idea to reviewed code without interactive gates. Alternatively, you can use interactive gates between phases to manually approve transitions and control the pipeline flow step by step.

Does Ralph Pipeline support marathon mode for planning all phases before execution?

Marathon mode provides a plan-all-then-execute flow by merging bead queues from all planning phases into a single inventory. This mode includes a bead inventory gate to review the merged queue before proceeding to headless or manual execution.

How do codemaps integrate with pipeline orchestration to share codebase context?

Codemaps integration shares codebase context with agents during pipeline execution and refreshes the codemaps post-execution for review. This ensures agents have accurate structural knowledge of the codebase throughout the 9-phase orchestration journey.

What are the limitations of using disk-based state persistence for cross-phase orchestration?

Disk-based state persistence maintains pipeline continuity across isolated contexts but requires local file system access within Claude Code. Context isolation via /clear between phases prevents bleed but means each phase cannot rely on previous session memory.