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.