workflow

Orchestrates seven TDD subagents through planning, testing, implementation, and gated review stages.

10|7|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/xiaolai/tdd-guardian-for-claude --skill workflow-xiaolai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workflow
Source: https://github.com/xiaolai/tdd-guardian-for-claude/tree/main/skills/tdd-guardian/workflow
Command: npx skills add https://github.com/xiaolai/tdd-guardian-for-claude --skill workflow-xiaolai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Enforcing strict test-driven development across a full feature implementation requires coordinating many specialized steps—planning, test design, adversarial spec review, implementation, coverage auditing, mutation testing, and final review—in the right order with the right test lanes at each stage. This Skill removes the guesswork by defining that orchestration explicitly, including mandatory stop conditions when gates fail. ## Core Features & Use Cases - Seven-stage subagent orchestration: Runs tdd-planner, tdd-test-designer, tdd-spec-adversary, tdd-implementer, tdd-coverage-auditor, tdd-mutation-auditor, and tdd-reviewer in a defined sequence with feedback loops. - Lane-aware execution: Runs only fast taskCompleted lanes in the inner implementation loop, deferring slower commit and push lanes to explicit gate checks at the end. - Mandatory stop conditions: Halts on any gate failure, treats zero-discovered-test lanes as failures, and never commits or pushes until gates are green. - Use Case: When asked to implement a new feature with strict TDD, the workflow produces a test matrix with specification levels, attacks it adversarially before any code exists, implements in small red-receipt batches, then audits coverage and mutation strength before final review. ## Quick Start Ask the assistant to implement a new feature using the strict TDD workflow with full gate enforcement.

Frequently Asked Questions about workflow

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

FAQPage Schema
How do I enforce strict TDD when implementing a new feature?

Use this workflow to run seven subagents in order: planning, test matrix design, adversarial spec review, batched implementation with red receipts, coverage auditing, optional mutation auditing, and final review. Each stage has defined stop conditions so no gate failure is silently skipped.

What is adversarial specification review in TDD?

The tdd-spec-adversary stage attacks the finished test matrix before any implementation exists, hunting for the simplest wrong implementation that would pass every test case. Gaps loop back to test redesign up to twice, and unresolved gaps are surfaced to the user rather than ignored.

When do slow test lanes like e2e or browser suites run?

The inner implementation loop runs only lanes bound to taskCompleted. Slower commit and push lanes run once at the end via explicit gate commands, so a 90-second browser suite gates git push rather than running after every task.

What happens if a test lane discovers zero tests?

A lane that discovers zero tests is treated as a failure, not a pass, and stops the workflow. The exception is bootstrap mode for greenfield lanes that have never had a test, which is reported loudly but not blocking until the lane runs its first test.

Does the workflow commit or push code automatically?

No. The workflow never commits or pushes until all gates are green, and the push gate is never run unprompted because it can take tens of minutes and may require services the user has not started.