When should I skip TDD while using this skill?

TDD is best avoided for UI layout and styling, simple configuration changes, glue code without logic, and early-stage exploratory prototyping.

What is the TDD Implementation skill for Claude Code?

It is a specialized workflow that guides Claude through the Test-Driven Development process, ensuring code is written only after a failing test has been established.

How does this skill handle Git commits?

The skill follows a specific TDD commit pattern, creating atomic commits for the failing test, the implementation, and the refactor phase to maintain a clean history.

Why is the 'Verify' step included in the workflow?

The Verify step ensures that the test created in the 'Red' phase actually captured the real bug or feature requirement, preventing 'passing tests' that don't actually fix the root issue.

TDD Implementation Workflow

Name: TDD Implementation Workflow
Author: cowwoc

bycowwoc

•

Security & Testing

Implements a disciplined Test-Driven Development cycle to ensure robust code quality through automated red-green-refactor patterns.

The TDD Implementation skill provides a structured framework for building software using Test-Driven Development within Claude Code. It guides the development process through a rigorous state machine—starting with failing tests (Red), moving to minimal functional implementation (Green), cleaning up code (Refactor), and finally verifying against the original use case. By enforcing atomic commit patterns and providing clear heuristics on when to apply TDD versus standard implementation, this skill helps developers eliminate regressions and ensure that every line of code serves a verified purpose.

Key Features

01Heuristics for choosing TDD vs. exploratory prototyping

02Atomic TDD-specific Git commit conventions

0356 GitHub stars

04Guided Red-Green-Refactor state machine transitions

05Conflict avoidance by updating existing behavior tests

06Logic verification against original failing use-cases

Use Cases

01Fixing complex logic bugs by capturing the failure in a test first

02Building state machines and workflows with upfront behavior specification

03Developing data transformation or validation engines with high reliability

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add cowwoc/cat tdd-implementation

For use in Claude.ai and ChatGPT

Download Skill