ralph-wiggum-loop-setup

Automate Ralph Wiggum loop setup for Claude Code with three-file structure.

9|2|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/DavidTeju/shared-skills --skill ralph-wiggum-loop-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-wiggum-loop-setup
Source: https://github.com/DavidTeju/shared-skills/tree/main/skills/ralph-wiggum-loop-setup
Command: npx skills add https://github.com/DavidTeju/shared-skills --skill ralph-wiggum-loop-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Set up and run a Ralph Wiggum autonomous loop for Claude Code when the official plugin is unavailable.

Core Features & Use Cases

  • Manual three-file setup mirroring the official plugin workflow: PROGRESS.md state tracker, PROMPT.md agent instructions, and ralph-loop.sh bash loop.
  • Oscillation detection, crash recovery, and completion signaling to ensure safe, repeatable iterations.
  • One-fix-per-iteration workflow with per-iteration commits for clean history when applying many deterministic changes.

Quick Start

Run the ralph-loop.sh script to start the autonomous loop.

Frequently Asked Questions about ralph-wiggum-loop-setup

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

FAQPage Schema
How do I set up an autonomous loop for Claude Code without the official plugin?

To set up an autonomous loop for Claude Code, this Skill automates the creation of a three-file bash scripting workflow, including a progress tracker, prompt instructions, and a loop script.

What is a Ralph Wiggum loop in bash scripting and when should I use it?

A Ralph Wiggum loop is an automated bash scripting iteration process for Claude Code. Use it when you need to apply many well-specified changes across iterations with progress tracking and per-iteration commits.

How do I track progress and detect oscillation in an automated Claude Code loop?

Progress tracking and oscillation detection are handled by the PROGRESS.md state tracker and ralph-loop.sh script. These files monitor iteration states to prevent infinite loops and ensure safe, repeatable changes.

Does this autonomous Claude Code loop setup support crash recovery?

Yes, the autonomous Claude Code loop setup supports crash recovery. Safeguards are built into the bash script and progress tracker to resume iterations safely after unexpected termination.

What's the best way to automate deterministic code changes across many iterations?

The best way to automate deterministic changes is using a one-fix-per-iteration workflow with explicit completion signaling. This approach maintains clean history through per-iteration commits and tracks progress.

What files are required to run a manual Ralph Wiggum loop for Claude Code?

Running a manual Ralph Wiggum loop requires three files: PROGRESS.md for state tracking, PROMPT.md for agent instructions, and ralph-loop.sh as the bash automation script.