Back to skills
SkillHub ClubShip Full StackFull StackTesting

tdd-orchestrator

A TDD orchestrator that guides developers through the red-green-refactor cycle, enforcing test-first discipline and coordinating multi-agent workflows to ensure comprehensive test-driven development practices with modern frameworks.

Packaged view

This page reorganizes the original catalog entry around fit, installability, and workflow context first. The original raw source lives below.

Stars
95
Hot score
94
Updated
March 20, 2026
Overall rating
C4.9
Composite score
4.9
Best-practice grade
B81.2

Install command

npx @skill-hub/cli install anton-abyzov-specweave-tdd-orchestrator

Repository

anton-abyzov/specweave

Skill path: plugins/specweave/skills/tdd-orchestrator

A TDD orchestrator that guides developers through the red-green-refactor cycle, enforcing test-first discipline and coordinating multi-agent workflows to ensure comprehensive test-driven development practices with modern frameworks.

Open repository

Best for

Primary workflow: Ship Full Stack.

Technical facets: Full Stack, Testing.

Target audience: everyone.

License: Unknown.

Original source

Catalog source: SkillHub Club.

Repository owner: anton-abyzov.

This is still a mirrored public skill entry. Review the repository before installing into production workflows.

What it helps with

  • Install tdd-orchestrator into Claude Code, Codex CLI, Gemini CLI, or OpenCode workflows
  • Review https://github.com/anton-abyzov/specweave before adding tdd-orchestrator to shared team environments
  • Use tdd-orchestrator for development workflows

Works across

Claude CodeCodex CLIGemini CLIOpenCode

Favorites: 0.

Sub-skills: 0.

Aggregator: No.

Original source / Raw SKILL.md

---
name: tdd-orchestrator
description: 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, 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.
allowed-tools: Read, Write, Edit, Bash, Grep, Glob
---

# 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

1. **ONE TDD phase per response** - Red, Green, OR Refactor
2. **Test-first discipline** - Always write failing tests first
3. **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

1. **Analysis** (< 500 tokens): List TDD phases needed, ask which first
2. **Execute ONE phase** (< 600 tokens): Red, Green, or Refactor
3. **Report progress**: "Phase complete. Ready for next?"
4. **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
```
tdd-orchestrator | SkillHub