ralph-loop

Coordinate bounded development increments with durable repo memory from AGENT.md and fix_plan.md.

Updated Apr 10, 2026

Search Tags:#spec-driven #validation #memory #loop #ralph #bounded-pass #operator-guided

Ready to run

npx skills add https://github.com/Caleb-T-Owens/ralph-mum --skill ralph-loop-caleb-t-owens

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: ralph-loop
Source: https://github.com/Caleb-T-Owens/ralph-mum/tree/main/ralph-loop
Command: npx skills add https://github.com/Caleb-T-Owens/ralph-mum --skill ralph-loop-caleb-t-owens

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provides a disciplined, bounded worker loop for Ralph-style development that preserves repo memory and guides a human operator through one meaningful increment per pass.

Core Features & Use Cases

Enforces one bounded, implement-and-validate increment per cycle with explicit stop reasons.
Preserves durable repo memory via AGENT.md, fix_plan.md, and spec files to drive rehydration and planning.
Supports greenfield or early-stage projects with spec-driven iteration and operator supervision.

Quick Start

Create or ensure AGENT.md, fix_plan.md, and a spec (spec.md or specs/) exist, then start the Ralph loop to perform one bounded increment per pass.

Frequently Asked Questions about ralph-loop

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

FAQPage Schema

How do I run supervised, spec-driven development loops for early-stage repositories?▼

Spec-driven development loops coordinate bounded, operator-guided passes that implement one meaningful increment per cycle, preserving durable repo memory via AGENT.md, fix_plan.md, and spec files for continuous rehydration.

What is a bounded-pass workflow for iterative software development?▼

A bounded-pass workflow enforces a single implement-and-validate increment per cycle with explicit stop reasons, requiring search-before-change, focused validation, and updates to fix_plan.md before emitting a final watchdog status.

Do I need specific files to start a spec-driven iteration loop?▼

Yes, spec-driven iteration loops require AGENT.md, fix_plan.md, and a spec file like spec.md or a specs/ directory to exist in the repository before starting the loop for proper memory rehydration and planning.

Can I use operator-guided development loops for greenfield projects?▼

Operator-guided development loops support greenfield or early-stage repositories requiring spec-driven iteration, applying durable repo memory to guide a human operator through one bounded increment per pass.

How does repo memory preservation work during supervised development passes?▼

Repo memory preservation works by reading AGENT.md and fix_plan.md, loading relevant specs, implementing a bounded increment, running focused validation, and updating fix_plan.md to maintain context across development cycles.

What are the limitations of bounded development loops for repository iteration?▼

Bounded development loops are limited to one meaningful increment per cycle with explicit stop reasons, requiring operator supervision and existing spec files, making them unsuitable for fully autonomous or unsupervised development workflows.