tdd-plan

Creates structured test-driven development plans with ordered test cases in .plans/ files.

Updated Jul 4, 2023
One-click install
npx skills add https://github.com/kohdice/dotfiles --skill tdd-plan-kohdice
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tdd-plan
Source: https://github.com/kohdice/dotfiles/tree/main/config/agents/skills/tdd-plan
Command: npx skills add https://github.com/kohdice/dotfiles --skill tdd-plan-kohdice

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It turns vague feature requests, behavior changes, and bug fixes into concrete, ordered test case plans following Kent Beck's Canon TDD, so implementation can proceed without ambiguity or missed edge cases. ## Core Features & Use Cases - Requirement Clarification: Applies an ambiguity threshold grounded in codebase conventions, asking targeted questions only when observable behavior decisions remain unsettled. - Test Case Design: Decomposes features into smallest testable increments ordered simple-to-complex, separating behavioral tests from structural Refactor items and marking integration tests. - Portable Plan Files: Writes self-contained Markdown plans to .plans/ with Goal, Context, and checkbox Test Cases that a fresh implementer or the implement skill can execute with zero session context. - Use Case: When asked to add a sequence diagram parser, the skill analyzes the codebase, clarifies API decisions, and produces .plans/sequence-parser.md with ordered test cases ready for execution via the implement skill or /tdd. ## Quick Start Ask the AI to create a TDD plan for the feature or bug fix you want, describing the desired behavior and letting it analyze the codebase first.

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 TDD plan for a new feature?▼

Describe the desired feature or behavior change and let the skill analyze your codebase and existing tests. It clarifies ambiguous decisions, then writes a plan file in .plans/ with ordered test cases you can execute with the implement skill or /tdd.

What is the difference between tdd-plan and work-plan?▼

tdd-plan covers application code changes with automatically testable behavior, producing ordered failing-test-first cases. Documentation, configuration, CI/CD, and infrastructure tasks have no testable behavior and should use the work-plan skill instead.

When should I not use TDD planning?▼

Skip TDD planning when no test case can fail before the change and pass after it, such as writing documentation, restructuring comments, or changing configuration and infrastructure. The skill will decline and suggest work-plan in those cases.

How are test cases ordered in a TDD plan?▼

Test cases progress from the simplest case, like empty input, through basic valid cases to complex combinations, with edge cases and error conditions last. Each test validates one behavior through the public API and builds on previous tests.

Can a TDD plan include refactoring steps?▼

Yes, structural changes appear as separate Refactor items placed immediately before the first Test item that depends on them. Refactor items must not change behavior and are never mixed with behavioral changes in a single item.

What happens after a TDD plan is created?▼

The skill prints the exact plan filename and .plans/ path. Typing go in the same session continues execution via the implement skill, or you can run /tdd with the filename in a later session.