skills.rest
audunstrand
audunstrandCOMMUNITY
Explore all skills by this author →
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
One-click install
npx skills add https://github.com/audunstrand/status-app --skill tdd-process
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
conejoRojoconejoRojo

using-git-worktrees

Create isolated git worktrees for parallel branch development.

Community
Advanced
haJ1thaJ1t

ship-readiness-checklist

Validate software release readiness across code quality, security, and deployment checks.

Community
Advanced
SocketDevSocketDev
56

scanning-quality

Analyze codebases for bugs, security issues, and quality metrics.

Official
Intermediate
AsiaOstrichAsiaOstrich
70

ATDD 助手

Guide teams through ATDD workflows with Given-When-Then acceptance criteria.

Community
Intermediate