ralph-wiggum

Coordinate multi-iteration tasks with task-file driven loops, pacing, and checkpoints.

446|40|Updated Jan 6, 2026
One-click install
npx skills add https://github.com/tmustier/pi-extensions --skill ralph-wiggum-tmustier
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-wiggum
Source: https://github.com/tmustier/pi-extensions/tree/main/ralph-wiggum
Command: npx skills add https://github.com/tmustier/pi-extensions --skill ralph-wiggum-tmustier

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Long-running iterative development loops with pacing control and verifiable progress. Use when tasks require multiple iterations, many discrete steps, or periodic reflection with clear checkpoints; avoid for simple one-shot tasks or quick fixes.

Core Features & Use Cases

  • Task-file driven iterations: Create and update a markdown task file to track goals and progress across iterations.
  • Pacing and reflection: Control iteration length, include optional reflection checkpoints, and surface progress summaries.
  • Multi-loop support: Run several Ralph loops in parallel and manage them from a single agent session.
  • Safe interrupt & resume: Use ESC to pause, then resume or stop deliberately; supports archiving completed work.

Quick Start

Start a Ralph loop by telling Pi to run /ralph start my-loop and then write a markdown task file describing goals and a checklist.

Frequently Asked Questions about ralph-wiggum

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

FAQPage Schema
How do I manage long-running iterative development tasks with verifiable progress?

Manage long-running iterative development tasks by driving iterations with a markdown task file, setting per-iteration pacing, and using reflection checkpoints to verify incremental progress updates.

What is the best way to structure multi-iteration feature development and refactoring?

Structure multi-iteration feature development and refactoring by creating a task file with goals and a checklist, then running loops that apply pacing and reflection checkpoints across discrete steps.

Can I run multiple development loops in parallel from a single session?

Run multiple development loops in parallel from a single agent session using multi-loop support, managing each loop independently with its own task file, pacing, and checkpoints.

How do checkpoints and pacing work for complex iterative loops?

Checkpoints and pacing control iteration length for complex loops by inserting reflection points, surfacing progress summaries, and ensuring structured iteration before proceeding to the next step.

When should I avoid using structured iteration loops for task management?

Avoid structured iteration loops for simple one-shot tasks or quick fixes, as the overhead of task-file driven iterations, pacing, and reflection checkpoints is designed for complex, multi-step requirements.

How do I safely interrupt and resume long-running loops?

Safely interrupt long-running loops by pressing ESC to pause, then resume or stop deliberately, with support for archiving completed work to preserve your task-file progress.