ralph-loop

Read fix_plan.md, apply the first unchecked task, verify, and commit.

1|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/wtthornton/tapps-brain --skill ralph-loop-wtthornton
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-loop
Source: https://github.com/wtthornton/tapps-brain/tree/main/.claude/skills/ralph-loop
Command: npx skills add https://github.com/wtthornton/tapps-brain --skill ralph-loop-wtthornton

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the smallest actionable unit of a Ralph development loop by reading fix_plan.md, applying the first unchecked task, validating the change, and committing it.

Core Features & Use Cases

  • Automated task selection: reads fix_plan.md to locate the first unchecked task.
  • Task execution & verification: applies the corresponding code change and runs targeted checks.
  • Progress tracking & commit: updates fix_plan.md and commits the result to the repository.

Quick Start

Run ralph-loop to execute the next unchecked task and commit the result.

Frequently Asked Questions about ralph-loop

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

FAQPage Schema
How do I automate incremental development tasks from a markdown plan?

To automate incremental development tasks, this Skill reads fix_plan.md, selects the first unchecked task, implements the code change, verifies it, commits the result, and updates the plan automatically.

What is a Ralph development loop and how does it manage codebase tasks?

A Ralph development loop manages codebase tasks by using fix_plan.md as a guiding checklist. The loop iterates by selecting a pending task, applying the modification, validating the change, and committing it to the repository.

Do I need a specific file format to track tasks for automated code commits?

Yes, you need a fix_plan.md file to track tasks for automated code commits. The execution contract requires this markdown file to locate the first pending item, apply the modification, and update the plan after committing.

How do I execute the next unchecked task in my development plan and commit it?

To execute the next unchecked task and commit it, run the automated loop iteration. It reads fix_plan.md, implements the first pending item, runs targeted checks to verify the change, updates the plan, and commits the result.

Can I use this automated task execution in any codebase?

You can use this automated task execution in Ralph-enabled codebases. It requires a fix_plan.md file to guide task selection and a codebase to modify, ensuring the execution contract is followed for each incremental change.

What happens if the targeted checks fail during the development loop?

If targeted checks fail during the development loop, the execution contract dictates that the task must be verified before committing. The loop applies the code change, runs targeted checks, and only commits the result upon successful validation.