tdd-workflow

Automate a 6-step test-driven development cycle for feature implementation.

59|9|Updated Jul 17, 2025
One-click install
npx skills add https://github.com/dgalarza/claude-code-workflows --skill tdd-workflow-dgalarza
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tdd-workflow
Source: https://github.com/dgalarza/claude-code-workflows/tree/main/plugins/tdd-workflow/skills/tdd-workflow
Command: npx skills add https://github.com/dgalarza/claude-code-workflows --skill tdd-workflow-dgalarza

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides developers through a true test-driven development workflow, ensuring tests drive design and code, reducing over-engineering and regression risk.

Core Features & Use Cases

  • Enforces a strict TDD cycle: write a failing test, implement the minimal code to pass, run tests, and refactor with confidence.
  • Supports safe incremental delivery by focusing on one discrete piece of functionality at a time.
  • Use Case: a developer adds a new feature in a feature branch and follows the 6-step process to ensure correctness and maintainability.

Quick Start

Describe to the AI how to implement a new feature by writing the smallest failing test first, then adding only the minimal code to make it pass, and repeating until the feature is complete.

Frequently Asked Questions about tdd-workflow

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

FAQPage Schema
How do I implement a test-driven development workflow for new features?

Test-driven development workflow is enforced by automating a strict 6-step cycle: writing a failing test, adding minimal code to pass, running tests, and refactoring. This ensures tests drive design and code, reducing over-engineering and regression risk.

What is the proper TDD cycle for writing unit tests and feature code?

The proper TDD cycle requires writing the smallest failing unit test first, implementing only the minimal code to make it pass, and then refactoring. You must run tests after every change to ensure correctness and maintainability.

Can I write all my unit tests upfront before implementing the feature code?

Writing all unit tests upfront is prohibited in this TDD workflow. You must focus on one discrete piece of functionality at a time, writing a single failing test and minimal passing code to support safe incremental delivery.

When do I need to refactor code during the TDD process?

Refactoring code during the TDD process happens after your minimal code passes the failing test. This approach allows you to improve code quality and maintainability with confidence, knowing your tests verify correctness and prevent regressions.

How do I guide an AI assistant to build software using a strict TDD workflow?

To guide an AI assistant using a strict TDD workflow, describe the feature implementation by instructing it to write the smallest failing test first, add only minimal code to pass, and repeat the cycle until the feature is complete.