workflow-tdd-plan-plan

Generate TDD planning artifacts with Red-Green-Refactor task chains and compliance reports.

1|Updated May 12, 2026
One-click install
npx skills add https://github.com/tcytan/tecton --skill workflow-tdd-plan-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow-tdd-plan-plan
Source: https://github.com/tcytan/tecton/tree/main/.claude/skills/workflow-tdd-plan
Command: npx skills add https://github.com/tcytan/tecton --skill workflow-tdd-plan-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns a vague implementation request into a rigorous TDD plan and then validates the resulting task chain and coverage, reducing the risk of shipping code without failing tests first.

Core Features & Use Cases

  • Unified TDD plan orchestration (6 phases): Converts input into TDD structure, creates or reuses a session, gathers context, analyzes test coverage, resolves conflicts when needed, generates Red-Green-Refactor task chains, and validates the task structure.
  • Conditional conflict resolution: Runs conflict analysis and resolution strategies only when the detected conflict risk is medium or high, updating planning notes and resolution artifacts accordingly.
  • TDD compliance verification & quality gate: Verifies task chain correctness and TDD phase adherence, runs/collects coverage metrics, and produces a binding quality gate report (with recommended next actions).

Quick Start

Run the TDD planning workflow in plan mode by invoking workflow-tdd-plan with your feature description.

Frequently Asked Questions about workflow-tdd-plan-plan

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

FAQPage Schema
How do I generate a TDD plan with Red-Green-Refactor task chains from a feature description?

To generate a TDD plan, the workflow orchestrates a 6-phase session that converts a feature description into IMPL_PLAN.md, IMPL-reek.json task files, and TODO_LIST.md, structuring each task with Red-Green-Refactor steps. It analyzes context and test coverage to enforce a test-first approach.

What is a TDD compliance report and how does a quality gate work?

A TDD compliance report is a TDD_COMPLIANCE_REPORT.md generated in verify mode that validates task chain correctness and TDD phase completeness. It includes a binding quality gate decision with recommended next actions based on collected coverage metrics.

How do I resolve code-plan conflicts during TDD planning?

To resolve code-plan conflicts, the workflow runs conflict analysis and applies resolution strategies only when detected conflict risk is medium or high. It updates planning notes and resolution artifacts to ensure the generated task metadata remains consistent.

Does every implementation task need all three Red-Green-Refactor steps?

Yes, every generated implementation task must contain exactly three internal TDD steps: red, green, and refactor. The tasks also include proper iteration limits for green test-fix cycles to ensure dependency-aware task structuring.

What is the best way to validate TDD phase completeness before shipping code?

The best way to validate TDD phase completeness is running the workflow's verify mode, which checks task chain correctness and runs coverage metrics. It outputs a TDD compliance report with a binding quality gate decision to prevent shipping code without failing tests first.