TDD Process

Enforce a six-state TDD workflow with mandatory state announcements and verification.

Updated Nov 2, 2025
One-click install
npx skills add https://github.com/SelrahcD/claude-marketplace --skill tdd-process-selrahcd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: TDD Process
Source: https://github.com/SelrahcD/claude-marketplace/tree/main/selrahcd-dot-claude/skills/tdd-process
Command: npx skills add https://github.com/SelrahcD/claude-marketplace --skill tdd-process-selrahcd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enforces a strict TDD governance model to ensure tests drive development, with mandatory state announcements, post-transition validation, and end-to-end verification.

Core Features & Use Cases

  • 6-state TDD workflow: PLANNING → RED → GREEN → REFACTOR → VERIFY → COMPLETE (+ BLOCKED)
  • 11 enforced rules to prevent vague implementations and ensure evidence-based transitions
  • Mandatory state announcements on every message
  • Post-condition validation before every transition
  • Compile and lint checks prior to green verification
  • Full test suite verification before completion

Quick Start

Activate the TDD discipline by requesting to use a TDD approach.

Frequently Asked Questions about TDD Process

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

FAQPage Schema
How do I enforce strict test-driven development discipline end-to-end?▼

A strict TDD governance model enforces test-driven development end-to-end by applying a 6-state workflow—PLANNING, RED, GREEN, REFACTOR, VERIFY, COMPLETE—with 11 enforced rules and mandatory state announcements for evidence-based transitions.

What is the state-machine workflow for TDD software testing?▼

The TDD state-machine workflow operates across six states: PLANNING, RED, GREEN, REFACTOR, VERIFY, and COMPLETE, plus a BLOCKED state. It mandates post-condition validation before every transition to ensure evidence-based progress.

How to validate code before green verification in a TDD process?▼

To validate code before green verification in the TDD process, you must execute compile and lint checks. These checks act as post-transition validations to ensure the implementation meets baseline quality standards before proceeding.

Does TDD governance require full test suite verification before completion?▼

Yes, TDD governance requires full test suite verification before completion. The workflow mandates end-to-end verification, including standard and edge cases, to satisfy the COMPLETE state's post-condition requirements.

Why do vague implementations fail TDD state transitions?▼

Vague implementations fail TDD state transitions because the process enforces 11 rules requiring evidence-based validation. Post-condition checks prevent moving forward without concrete proof that tests pass and code compiles correctly.