Does this skill work with any programming language?

Yes, as long as your environment has a test runner, compiler, or linter accessible via the terminal, the TDD Process skill can manage the workflow for any language.

How do I trigger the TDD Process skill in Claude Code?

You can activate the skill by using natural language triggers such as 'use a TDD approach', 'start TDD', or 'test-drive this feature' within your Claude Code session.

Why does Claude prefix every message with a TDD state?

Prefixing ensures absolute alignment between the AI and the developer, preventing the model from skipping the 'Planning' or 'Red' phases and jumping straight to implementation.

What happens if the state machine is violated?

The skill features a meta-governance protocol that monitors for state mismatches. If a state is skipped or evidence is missing, Claude will issue a 'STATE VIOLATION DETECTED' alert and recover to the last valid state.

Does it automatically run my tests?

Yes, the skill is designed to use Claude's bash capabilities to execute test commands, capture the output, and verify if a test has actually failed or passed as claimed.

Strict TDD State Machine

Name: Strict TDD State Machine
Author: NTCoding

byNTCoding

•

セキュリティとテスト

Enforces a disciplined Red-Green-Refactor workflow through a rigorous state machine to ensure verifiable software quality.

The TDD Process skill transforms Claude into a high-integrity engineering partner by implementing a mandatory state machine that governs the entire development lifecycle. By forcing explicit state announcements (Planning, Red, Green, Refactor, Verify) and requiring verifiable evidence via tool calls before every transition, this skill eliminates shortcuts and ensures that code is only implemented to satisfy failing tests. It is particularly effective for teams requiring high test coverage, strict architectural adherence, and bug-free deployments through continuous linting and compilation checks.

主な機能

01Mandatory state prefixing on every message for absolute transparency

02Meta-governance layer that automatically detects and recovers from state violations

03Strict Red-Green-Refactor cycle enforcement to prevent implementation shortcuts

04Integrated compilation and linting checks as part of the Green phase

05Evidence-based transitions requiring bash tool verification of test results

0678 GitHub stars

ユースケース

01Large-scale code refactoring where maintaining a green test suite is essential

02Reproducing and fixing complex bugs by establishing a 'meaningful failure' first

03Implementing critical business logic that requires 100% unit test coverage

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