Does this skill work with any testing framework?

Yes, it uses standard bash tools to run your project's specific test commands (npm test, pytest, etc.) and interprets the output.

How do I start a TDD session with Claude?

Simply use activation phrases like 'start TDD', 'use a TDD approach', or 'test-drive this' to trigger the state machine.

What is the 'Refactor' state for?

Once a test passes (Green), the skill forces an assessment of code quality, encouraging you to improve design, naming, and architecture before finishing.

What happens if I try to write code before a test?

The skill's governance will flag a state violation. It requires a 'Planning' phase and a 'Red' phase (failing test) before any production code is written.

Why does Claude prefix every message with an emoji?

The prefix (e.g., 🔴 TDD: RED) is a mandatory visual indicator to ensure the TDD lifecycle is strictly followed without skipping critical steps.

TDD Process State Machine

Name: TDD Process State Machine
Author: NTCoding

byNTCoding

•

安全与测试

Enforces a strict test-driven development workflow using a governed Red-Green-Refactor state machine.

The TDD Process skill transforms Claude into a disciplined development partner by enforcing a rigorous test-driven state machine. It mandates a 'test-first' approach where implementation only begins after a meaningful test failure is established. By requiring state announcements in every message (Planning, Red, Green, Refactor, Verify), it prevents over-engineering and ensures that every line of code is justified by a requirement and verified by an automated suite. This skill is essential for developers seeking high-integrity codebases and 100% functional test coverage.

主要功能

01Mandatory state-prefixing on every message to maintain context and discipline

0294 GitHub stars

03Minimal implementation enforcement to prevent premature optimization

04Automated verification of test failures and successes via tool execution

05Strict state machine governance (Planning, Red, Green, Refactor, Verify, Blocked)

06Integrated linting and compilation checks before cycle completion

使用场景

01Refactoring legacy components with a guaranteed safety net of verification

02Building new features with total test coverage and architectural discipline

03Debugging complex issues by reproducing them with failing tests first

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ntcoding/claude-skillz tdd-process

For use in Claude.ai and ChatGPT

Download Skill