tdd-workflow

Automate RED-GREEN-REFACTOR test-driven development workflows with TodoWrite tracking.

2|Updated Jan 16, 2026
One-click install
npx skills add https://github.com/MysMon/Spec-Workflow-Toolkit --skill tdd-workflow-mysmon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tdd-workflow
Source: https://github.com/MysMon/Spec-Workflow-Toolkit/tree/main/skills/workflows/tdd-workflow
Command: npx skills add https://github.com/MysMon/Spec-Workflow-Toolkit --skill tdd-workflow-mysmon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This workflow provides a disciplined, repeatable approach to test-driven development within Claude Code, ensuring that tests drive design and prevent regression.

Core Features & Use Cases

  • Enforces the RED-GREEN-REFACTOR cycle to guide feature development, bug fixes, and refactors.
  • Includes guidance for writing failing tests first and minimal implementations that pass tests.
  • Integrates with TodoWrite to track progress through each TDD cycle and maintain change history.

Quick Start

Describe a feature, write a failing test, then implement minimally to pass and refactor as needed.

Frequently Asked Questions about tdd-workflow

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

FAQPage Schema
How do I automate a test-driven development workflow in Claude Code?

The RED-GREEN-REFACTOR cycle is a test-driven development process where you write a failing test first, implement the minimal code required to make it pass, and then refactor the implementation while maintaining test coverage. This workflow automates that cycle for feature development and bug fixes.

How do I track TDD progress when writing failing tests and refactoring?

You can track test-driven development progress using TodoWrite integration, which maintains change history and monitors completion through each RED-GREEN-REFACTOR cycle. This ensures disciplined, repeatable progress tracking across feature development and refactoring tasks.

Can I use this TDD workflow for bug fixes and refactoring existing code?

Yes, this test-driven development workflow is designed for feature development, bug fixes, and refactors. It guides design by requiring failing tests first and minimal implementations that pass tests, preventing regression across all supported task types.

What is the best way to start a RED-GREEN-REFACTOR cycle for a new feature?

To start a RED-GREEN-REFACTOR cycle, describe the feature, write a failing test that defines the expected behavior, then implement the minimal code required to pass the test. After achieving a passing state, refactor the code while keeping tests green.

Does this test-driven development workflow require any external dependencies?

No, this test-driven development workflow has zero dependencies. It operates natively within Claude Code, using TodoWrite for progress tracking and requiring only a SKILL.md file with a name and description to validate Skill Units.