Workflow
Skill xiaolai/tdd-guardian-for-claude/skills/tdd-guardian/workflow
Orchestrate strict TDD implementation across planner, test designer, spec adversary, implementer, coverage auditor, mutation auditor, and reviewer subagents.From its SKILL.md
npx -y skills add xiaolai/tdd-guardian-for-claude --skill workflowAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 10 stars10 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
2.9 KB, as published. Nobody here has run it
TDD Workflow
Use this workflow when user asks for implementation with strict TDD enforcement.
Orchestration order
tdd-planner- Produce work items and acceptance criteria.
tdd-test-designer- Produce full edge-case/boundary/guard test matrix, with a lane, an assertion level, and a spec level (S1-S6) per case, plus the law question answered once per unit.
tdd-spec-adversary- Attack the finished matrix for the simplest wrong implementation that passes every case. Loop back to step 2 with any gaps, up to twice. This is the only stage that runs before an implementation exists, and therefore the only one judging a specification that is still independent of one.
tdd-implementer- Implement work items in small batches, recording a red receipt per item, verifying against the
taskCompletedlanes only — the fast inner loop.
- Implement work items in small batches, recording a red receipt per item, verifying against the
tdd-coverage-auditor- Run every lane with
coverage: "include", merge the reports, enforce thresholds against the merge and against everycriticalPathsentry.
- Run every lane with
tdd-mutation-auditor(if mutation gate enabled)- Validate test strength and report surviving mutants with the boundary test that would kill each. The implementer writes them.
tdd-reviewer- Findings-first final review: the lane audit, specification strength, the change tax, and any
SEPARATION-BROKENreceipt.
- Findings-first final review: the lane audit, specification strength, the change tax, and any
Lanes in the workflow
The inner loop (step 4) runs only taskCompleted lanes. Slower lanes run once, at the end:
- Before handing back, run
/tdd-guardian:gate commitso the commit lanes are fresh. - If the change touches anything a
pushlane covers, say so and point at/tdd-guardian:gate push. Do not run it unprompted — it can take tens of minutes and may need services the user has not started.
Mandatory stop conditions
- Stop if any gate fails.
- A lane that discovered zero tests is a failure, not a pass.
- An environment failure (missing runner, OOM, timeout) stops the workflow and never triggers a code fix.
- Do not commit/push until gates are green.
- Provide a final checklist with pass/fail for each lane and each gate, naming every dimension that was NOT configured rather than omitting it.
- Adversary gaps still open after two redesign rounds do not silently proceed — surface them and let the user decide.
Scope
Covers orchestration only: the order the seven subagents run in, which lanes run at which stage, and the stop conditions.
Each stage's own rules live elsewhere — tdd-guardian:policy-core for test quality, tdd-guardian:lane-policy for tiers, tdd-guardian:test-matrix for the matrix format, tdd-guardian:coverage-gate and tdd-guardian:mutation-gate for the gates, and tdd-guardian:review-gate for the final review.