What happens if implementation code is written before a test?

The skill's protocol requires that any implementation code written without a prior failing test be deleted and the cycle restarted correctly to ensure all code is trusted.

Why is file-based logging required?

File-based logging provides objective, verifiable evidence of application behavior. It ensures that testing results are based on actual logs rather than just terminal output.

What are the Execution Gates?

A mandatory 6-step sequence (Build, Launch, Wait, Check Process, Read Logs, and Verify Logs) that must be completed and documented before running E2E tests or taking screenshots.

When is an E2E test required?

E2E tests are required for all user-facing features, including API endpoints, UI components, CLI commands, and visual changes, in addition to standard unit tests.

What is the Iron Law of TDD in this skill?

The Iron Law mandates that a failing test must be written, executed, and observed to fail (the RED step) before any implementation code is allowed to be written.

TDD Workflow Pro

Name: TDD Workflow Pro
Author: edwinhu

byedwinhu

•

Security & Testing

Enforces a strict Test-Driven Development cycle with mandatory failing tests, execution gates, and comprehensive logging for reliable software implementation.

This skill transforms Claude into a disciplined TDD practitioner, ensuring that every feature and bug fix is driven by a failing test. It mandates a rigorous Red-Green-Refactor workflow, requiring the AI to prove failures before implementing code and verifying success through a unique 6-stage execution gate. By emphasizing file-based logging and mandatory end-to-end testing for all user-facing features, it minimizes regressions and ensures that the implementation strictly adheres to the specified requirements while maintaining a verifiable audit trail of progress.

Key Features

01Mandatory 6-stage Execution Gate verification protocol

02Strict Red-Green-Refactor cycle enforcement

03Automatic TDD progress documentation in LEARNINGS.md

045 GitHub stars

05Integrated file-based logging for runtime evidence

06Requirement for E2E tests on all user-facing features

Use Cases

01Standardizing testing workflows and documentation for collaborative software projects.

02Building mission-critical features where correctness and reliability are paramount.

03Debugging complex logic by writing regression tests before implementing fixes.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add edwinhu/workflows dev-tdd

For use in Claude.ai and ChatGPT

Download Skill