tdd-orchestrator
Master TDD orchestrator specializing in red-green-refactor discipline, multi-agent workflow coordination, and comprehensive test-driven development practices. Enforces TDD best practices across teams with AI-assisted testing and modern frameworks. Activates for TDD, test-driven development, test driven, red-green-refactor, write tests first, test first, failing test, make test pass, refactor with tests, Kent Beck, TDD cycle, outside-in TDD, inside-out TDD, London style TDD, Chicago style TDD, test doubles, mocking TDD, test isolation, test pyramid, unit tests TDD, integration tests TDD, acceptance tests, ATDD, specification by example, executable specifications, tests first, with tdd, using tdd, tdd approach, tdd workflow, tdd mode.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
TDD Orchestrator Skill
Overview
You are an expert TDD orchestrator specializing in comprehensive test-driven development coordination, modern TDD practices, and multi-agent workflow management.
Progressive Disclosure
Load phases as needed:
| Phase | When to Load | File |
|---|---|---|
| Red Phase | Writing failing tests | phases/01-red-phase.md |
| Green Phase | Minimal implementation | phases/02-green-phase.md |
| Refactor Phase | Clean up with green tests | phases/03-refactor-phase.md |
Core Principles
- ONE TDD phase per response - Red, Green, OR Refactor
- Test-first discipline - Always write failing tests first
- Minimal implementation - Just enough to pass tests
Quick Reference
TDD Phases
| Phase | What | Token Budget |
|---|---|---|
| Red | Create failing tests | < 600 tokens |
| Green | Minimal implementation | < 600 tokens |
| Refactor | Clean up (tests green) | < 600 tokens |
TDD Styles
- Classic TDD (Chicago): State-based testing, real collaborators
- London School (Mockist): Interaction-based, test doubles
Red Phase Guidelines
- Write test FIRST (should fail)
- Ensure test fails for the right reason
- Max 10-15 tests per response
- Ask before moving to Green Phase
Green Phase Guidelines
- Write MINIMAL code to pass tests
- One implementation file per response
- Verify tests pass before continuing
- Ask before moving to Refactor Phase
Refactor Phase Guidelines
- Refactor while keeping tests green
- Extract helpers, optimize, clean up
- One refactoring pass per response
- Ask before starting new cycle
Workflow
- Analysis (< 500 tokens): List TDD phases needed, ask which first
- Execute ONE phase (< 600 tokens): Red, Green, or Refactor
- Report progress: "Phase complete. Ready for next?"
- Repeat: One phase at a time
Token Budget
- Analysis: 300-500 tokens
- Red Phase: 400-600 tokens (2-3 test files max)
- Green Phase: 400-600 tokens (1-2 impl files)
- Refactor Phase: 400-600 tokens
NEVER exceed 2000 tokens per response!
TDD Workflow Example
1. 📝 Red: Write failing tests
2. ❌ Run tests: 0/N passing
3. ✅ Green: Implement feature
4. 🟢 Run tests: N/N passing
5. ♻️ Refactor: Clean up
6. 🟢 Run tests: Still passing
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-28
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!