tdd-go

Automate the TDD cycle by orchestrating RED, GREEN, and REFACTOR phases.

Updated Nov 10, 2025
One-click install
npx skills add https://github.com/SwiftyJunnos/Claude-Code-with-TDD --skill tdd-go
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tdd-go
Source: https://github.com/SwiftyJunnos/Claude-Code-with-TDD/tree/main/.claude/skills/tdd-go
Command: npx skills add https://github.com/SwiftyJunnos/Claude-Code-with-TDD --skill tdd-go

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the entire Test-Driven Development (TDD) cycle, from identifying the next test to implementing and refactoring code, ensuring adherence to TDD principles.

Core Features & Use Cases

  • Automated TDD Cycle: Orchestrates the Red-Green-Refactor loop for efficient development.
  • Test Plan Integration: Automatically finds and marks the next test from a PLAN.md file.
  • Use Case: When starting a new feature, simply tell the AI to "go" and it will handle writing the failing test, implementing the minimum code to pass, and refactoring, all while keeping you informed.

Quick Start

Use the tdd-go skill to start the next TDD iteration.

Frequently Asked Questions about tdd-go

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

FAQPage Schema
How do I automate the test-driven development workflow?

Automating the TDD workflow requires orchestrating the RED, GREEN, and REFACTOR phases to write failing tests, implement minimum code, and refactor. This Skill executes that cycle by reading a PLAN.md file, writing one test at a time, and applying the smallest possible changes to pass.

How does automated TDD cycle handle the RED, GREEN, and REFACTOR phases?

The automated TDD cycle handles the RED, GREEN, and REFACTOR phases by identifying the next test, writing a failing test, implementing the minimum code to pass, and optionally refactoring. It ensures strict adherence to TDD principles by processing one test at a time from your PLAN.md file.

Can I use a test plan to drive automated test generation?

Yes, you can use a test plan to drive automated test generation by placing your planned tests in a PLAN.md file. The Skill automatically finds and marks the next test from this file, ensuring the automated TDD cycle systematically works through your planned test cases one by one.

What is the best way to enforce strict TDD principles during development?

The best way to enforce strict TDD principles is to automate the RED, GREEN, and REFACTOR loop while restricting code changes to the smallest possible increments. This Skill guarantees adherence by writing one test at a time and implementing only the minimum code required to pass.

Do I need a PLAN.md file to start the automated TDD cycle?

Yes, you need a PLAN.md file to start the automated TDD cycle because the Skill uses it to identify and mark the next test. This file drives the workflow, allowing the system to automatically select the next failing test to write and implement.

When should I not use automated test-driven development workflow?

You should not use an automated test-driven development workflow when your project lacks a structured PLAN.md file or when exploratory coding requires flexible, rapid changes outside strict TDD principles. The automation relies on predefined test plans and making the smallest possible changes sequentially.