What problem does it solve?
This Skill helps you implement features, bug fixes, and refactors with confidence by forcing a test-first plan anchored in invariants and a risk-focused test strategy.
Core Features & Use Cases
- Framework-driven TDD: Uses first-principles by default, but routes each TODO through best-fit reasoning/testing frameworks via the think skill.
- Plan-first, test-first execution: Produces a Phase 1 TODO plan (paths, dependencies, invariants, risk flags, known unknowns) before writing any production code.
- RED-GREEN-REFACTOR with review gates: Iterates through failing tests, minimal passing implementation, and refactoring while enforcing review checks (including optional deep review).
- Interactive or autopilot modes: Supports --sub-skill (silently plan/emit TODOs for orchestrators) and --plan-only (emit TODO YAML and stop after Phase 1).
Quick Start
Use the tdd-workflow skill to implement your change by asking it to run a TDD loop on your TODO: "tdd-workflow implement plan for this feature with tests first."