Use this skill when writing new features, fixing bugs, or refactoring code. Enforces test-driven development with canonical risk-appropriate coverage including unit, integration, and E2E tests.
Installs into .claude/skills of the current project.
Are you the author of Tdd Workflow?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/nmor-tdd-workflow-the-council)
---
name: tdd-workflow
description: Use this skill when writing new features, fixing bugs, or refactoring code. Enforces test-driven development with canonical risk-appropriate coverage including unit, integration, and E2E tests.
disable-model-invocation: true
---
# Test-Driven Development Workflow
> **Size budget: 8 KB** — `token-budget.mjs --check`.
Use this skill when writing new features, fixing bugs, or refactoring code. Enforces test-driven development with canonical risk-appropriate coverage including unit, integration, and E2E tests.
## Working procedure
1. Establish the relevant mode and existing evidence; do not repeat completed intake.
2. Start with a failing test for a behavioral defect or substantive feature, then implement and refactor. Assert state and side effects, including failure paths. Preserve repository/user coverage policy; Go coverage measures statements, not branch coverage. Reversible low-impact prose/config edits need proportionate verification.
3. Read only the corresponding sections below before applying their examples.
4. Verify the result with meaningful positive, negative and failure controls. Record actual outcomes, limitations and next action.
## Selected references
- [When to Activate](references/procedure.md#when-to-activate) — read when this part of the task applies.
- [Core Principles](references/procedure.md#core-principles) — read when this part of the task applies.
- [TDD Workflow Steps](references/procedure.md#tdd-workflow-steps) — read when this part of the task applies.
- [Testing Patterns](references/procedure.md#testing-patterns) — read when this part of the task applies.
- [Test File Organization](references/procedure.md#test-file-organization) — read when this part of the task applies.
- [Mocking External Services](references/procedure.md#mocking-external-services) — read when this part of the task applies.
- [Test Coverage Verification](references/procedure.md#test-coverage-verification) — read when this part of the task applies.
- [Common Testing Mistakes to Avoid](references/procedure.md#common-testing-mistakes-to-avoid) — read when this part of the task applies.
- [Continuous Testing](references/procedure.md#continuous-testing) — read when this part of the task applies.
- [Best Practices](references/procedure.md#best-practices) — read when this part of the task applies.
- [Success Metrics](references/procedure.md#success-metrics) — read when this part of the task applies.
- [Purpose](references/procedure.md#purpose) — read when this part of the task applies.
- [When NOT to use](references/procedure.md#when-not-to-use) — read when this part of the task applies.
- [Standards Cited](references/procedure.md#standards-cited) — read when this part of the task applies.
The [full procedure](references/procedure.md) preserves detailed examples and standards.
Load relevant excerpts rather than the entire reference. Runtime capabilities and higher-priority instructions govern imported templates.
