tdd-plan

Generate a TDD execution plan with master goals, phases, and exit criteria.

Updated Nov 18, 2025
One-click install
npx skills add https://github.com/cajias/claude-skills --skill tdd-plan-cajias
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tdd-plan
Source: https://github.com/cajias/claude-skills/tree/main/skills/tdd-plan
Command: npx skills add https://github.com/cajias/claude-skills --skill tdd-plan-cajias

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you convert an implementation request into a structured, iterative test-driven development plan so work can be executed safely, validated repeatedly, and refined until it is ready to ship.

Core Features & Use Cases

  • TDD Planning: Breaks a task into master goals, failing tests, implementation steps, refactoring, and validation.
  • Iteration Control: Adds exit criteria, investigation tracking, and commit guidance for repeated execution in ralph-loop.
  • Validation Workflow: Includes unit tests, build, lint, deploy, integration tests, and PR review checks when relevant.
  • Use Case: A developer asks for a plan to add JWT authentication and wants a loop-friendly workflow that keeps testing, reviewing, and refining until everything passes.

Quick Start

Ask for a TDD plan for your task and include any deploy or integration test commands you want validated.

Frequently Asked Questions about tdd-plan

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

FAQPage Schema
How do I create a test-driven development plan for iterative software delivery?

A test-driven development plan breaks a task into master goals, failing tests, implementation steps, refactoring, and validation. This Skill generates that structured TDD workflow from a task description, adding exit criteria and commit guidance for repeated execution.

What's the best way to plan a feature with failing tests, refactoring, and PR review checks?

To plan a feature with failing tests and PR review checks, provide a task description and any deploy or integration test commands. The Skill produces a ralph-loop-ready workflow covering unit tests, build, lint, deploy, integration tests, and PR review.

Can I use a TDD plan workflow for bug fixes and multi-step engineering tasks?

Yes, a TDD plan workflow applies to bug fixes and multi-step engineering tasks that need repeated validation. The generated plan includes investigation tracking, explicit exit criteria, and validation steps to ensure the work is ready to ship.

How does iteration control work in a TDD-based execution plan?

Iteration control in a TDD-based execution plan uses explicit exit criteria, investigation tracking, and commit guidance to manage repeated execution. This allows the workflow to loop through testing, reviewing, and refining until all validation checks pass.

Do I need to provide deployment or integration test commands to generate a TDD plan?

You do not need to provide deployment or integration test commands to generate a basic TDD plan. However, including them allows the Skill to add deploy checks and integration tests to the validation workflow, producing a more comprehensive ralph-loop-ready plan.

What is a ralph-loop TDD plan and when do I need one?

A ralph-loop TDD plan is a structured execution plan for iterative software delivery that cycles through tests, builds, linting, deploy checks, and PR review. You need one when work must be validated repeatedly and refined until it is ready to ship.