ralph-wiggum

Create and manage iterative TDD development plans using PRD documents and CONTEXT.md logs.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/mccarthysean/strictly-dancing --skill ralph-wiggum-mccarthysean
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-wiggum
Source: https://github.com/mccarthysean/strictly-dancing/tree/main/.claude/skills/ralph-wiggum
Command: npx skills add https://github.com/mccarthysean/strictly-dancing --skill ralph-wiggum-mccarthysean

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ralph Wiggum provides a structured approach to planning and managing iterative TDD development using PRD documents, CONTEXT.md logs, and a controlled external loop.

Core Features & Use Cases

  • PRD-driven planning: Create and manage a detailed PRD for development tasks with passes tracking.
  • Progress logging: Maintain a persistent CONTEXT.md that records iteration progress across tasks.
  • Deterministic iterations: Use the external loop to run one task per iteration and progressively complete all work.
  • Verification discipline: Enforce unit-test and Playwright verification as part of the task completion workflow.
  • Use Case: A team uses Ralph Wiggum to coordinate feature development from planning to verification in a PRD-driven sprint.

Quick Start

Initialize a plan folder, craft a prd.json with tasks, then run the external loop script to begin iterating tasks.

Frequently Asked Questions about ralph-wiggum

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

FAQPage Schema
How do I manage iterative TDD development using a PRD?

Iterative TDD development using a PRD is managed by creating a prd.json with tasks and maintaining a CONTEXT.md log. An external loop script spawns one task per iteration, records progress, and loops until all tasks are complete.

What is an external loop in TDD plan management?

An external loop in TDD plan management is a script that orchestrates iterative development by spawning one task per iteration from a prd.json file. It records progress in CONTEXT.md and loops until all tasks are complete.

How do I track TDD iteration progress across multiple development tasks?

TDD iteration progress is tracked across tasks using a persistent CONTEXT.md log that records iteration progress. Combined with a prd.json containing tasks and passes tracking, it maintains a complete history of development progress.

Can I enforce Playwright and unit-test verification in a TDD workflow?

Yes, Playwright and unit-test verification can be enforced in a TDD workflow as part of the task completion workflow. The external loop ensures verification discipline by requiring tests pass before moving to the next iteration.

Do I need a prd.json file to start iterative TDD planning?

Yes, a prd.json file with tasks is required to start iterative TDD planning. You also need a CONTEXT.md progress log and the ralph-external-loop script to orchestrate iterations and progressively complete all work.

What's the best way to run one task at a time in a TDD development plan?

The best way to run one task at a time in a TDD development plan is using an external loop script that spawns tasks sequentially. It processes a single task per iteration, records progress in CONTEXT.md, and loops until completion.