Strict TDD State Machine

About

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.

Key Features

• Mandatory state prefixing on every message for absolute transparency
• Meta-governance layer that automatically detects and recovers from state violations
• Strict Red-Green-Refactor cycle enforcement to prevent implementation shortcuts
• Integrated compilation and linting checks as part of the Green phase
• Evidence-based transitions requiring bash tool verification of test results
• 78 GitHub stars

Use Cases

• Large-scale code refactoring where maintaining a green test suite is essential
• Reproducing and fixing complex bugs by establishing a 'meaningful failure' first
• Implementing critical business logic that requires 100% unit test coverage