TDD Guide

Test-Driven Development companion — write failing tests first, implement the minimum code to pass, then refactor with confidence and full coverage tracking.

Features

• Test-First Scaffolding — Generates test stubs from feature descriptions before any implementation
• Red-Green-Refactor Cycle — Guides you through each TDD phase with automated verification
• Coverage Tracking — Monitors line, branch, and function coverage in real-time
• Multi-Framework Support — Works with Jest, Vitest, Pytest, Go testing, and more
• Mutation Testing — Validates test quality by introducing code mutations and checking detection rate

Quick Start

claude skill install tdd-guide

Usage

# Start a TDD cycle for a new feature
/tdd-guide "user registration with email verification"

# Run the red-green-refactor loop on existing tests
/tdd-guide cycle --test src/user.test.ts

How It Works

Follows the classic TDD cycle: writes a failing test based on your feature description, implements the minimum code to make it pass, then suggests refactoring opportunities. Continuously tracks test coverage and flags untested code paths. Supports mutation testing to verify your tests actually catch real bugs.

Compatibility

Works with Claude Code, Codex, Gemini CLI, Cursor, Windsurf, and Aider.