Verified:GitHub

TDD Process

Enforce TDD state-machine governance requiring explicit post-conditions and verifiable test evidence in every assistant message prefix.

Updated Dec 6, 2025

Search Tags:#tdd #verification #observability #governance #state-machine #ai-skill

Ready to run

npx skills add https://github.com/audunstrand/status-app --skill tdd-process

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: TDD Process
Source: https://github.com/audunstrand/status-app/tree/main/.github/skills/tdd-process
Command: npx skills add https://github.com/audunstrand/status-app --skill tdd-process

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enforces strict Test-Driven Development state-machine governance for AI interactions, ensuring every message starts with the current TDD state, transitions are validated by explicit post-conditions, and outputs include verifiable test results.

Core Features & Use Cases

State-driven prompts: every assistant message begins with the current TDD state prefix (PLANNING, RED, GREEN, REFACTOR, VERIFY, BLOCKED).
Post-condition validations: requires explicit success/failure evidence before transitioning states.
Auditable workflow: maintains a trace of tests, commands, and transitions to support coaching, training, and automation scenarios.

Quick Start

Activate the TDD governance by requesting: "start TDD" or "use a TDD approach" and the agent will initiate in PLANNING, guide the RED/GREEN/REFACTOR/VERIFY cycle, and show exact test outputs.

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 TDD state-machine governance for AI agent interactions?▼

TDD state-machine governance works by requiring every assistant message to begin with a current TDD state prefix like PLANNING, RED, or GREEN. It validates state transitions using explicit post-conditions and verifiable test evidence before proceeding.

How do I start a TDD cycle with an AI agent?▼

To start a TDD cycle, prompt the agent with a request like "start TDD" or "use a TDD approach". The agent will initiate in the PLANNING state and guide you through the RED, GREEN, REFACTOR, and VERIFY cycle while displaying exact test outputs.

Can I use TDD process governance for AI automation and training scenarios?▼

Yes, TDD process governance suits AI automation, coaching, and training scenarios. It maintains an auditable workflow trace of tests, commands, and state transitions to support these activities.

What is the best way to verify AI agent test outputs during development?▼

The best way to verify AI agent test outputs is to use a governance skill that requires explicit success or failure evidence before transitioning TDD states. This ensures all outputs include verifiable test results.

Why does my AI agent get blocked during TDD workflows?▼

AI agents get blocked during TDD workflows when explicit post-condition validations fail. The TDD state-machine enters a BLOCKED state, halting transitions until verifiable test evidence is successfully provided.