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.