plan-tdd

Generate structured TDD runbooks from design documents.

Updated Jan 19, 2026
One-click install
npx skills add https://github.com/ddaanet/agent-core --skill plan-tdd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-tdd
Source: https://github.com/ddaanet/agent-core/tree/main/skills/plan-tdd
Command: npx skills add https://github.com/ddaanet/agent-core --skill plan-tdd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill translates a design document into a complete, executable plan for TDD runbooks, enabling teams to orchestrate RED-GREEN-REFACTOR cycles with structured phases, reviews, and tooling integration.

Core Features & Use Cases

  • From design to runbook: Converts goals, decisions, and phase structure into a ready-to-process plan.
  • Phase planning and sequencing: Outlines cycles (X.Y) with RED-GREEN-Stop guidance and dependency mapping.
  • Review and governance: Integrates with tdd-plan-reviewer and prepare-runbook.py for automated validation and assembly.
  • Output-ready artifacts: Produces per-phase runbook content and final runbook structure for orchestration.
  • Use Case: A design document for a new feature is transformed into a complete runbook ready for automated execution.

Quick Start

Start by placing a design document under /design and run the /plan-tdd skill to generate a phase outline and first draft of the runbook.

Frequently Asked Questions about plan-tdd

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

FAQPage Schema
How do I generate a TDD runbook from a design document?

TDD runbook generation translates design goals and decisions into a structured phase outline by mapping RED-GREEN-REFACTOR cycles. It extracts phase structure and increments to produce output-ready artifacts for automated execution and validation.

What is a RED-GREEN-REFACTOR cycle in automated TDD planning?

A RED-GREEN-REFACTOR cycle in TDD planning is a structured phase sequence where RED writes failing tests, GREEN implements code to pass, and REFACTOR optimizes. The skill maps these cycles with dependency tracking and Stop guidance for deterministic execution.

How do I sequence TDD phases and map dependencies for a new feature?

Sequencing TDD phases involves mapping cycles labeled X.Y with explicit RED-GREEN-Stop guidance and dependency mapping. The skill extracts design decisions to outline these increments, ensuring traceable phase plans ready for orchestration.

Does plan-tdd work with prepare-runbook.py for automated validation?

Yes, plan-tdd integrates with prepare-runbook.py for automated validation and assembly. It produces per-phase runbook content and a final runbook structure that feeds directly into the prepare-runbook.py tool for orchestration.

Can I use this TDD planning approach for projects with strict review and governance requirements?

Yes, this TDD planning approach suits projects with strict governance by integrating with tdd-plan-reviewer and prepare-runbook.py for automated validation. It ensures traceable phase plans and structured reviews throughout the runbook assembly process.