# tdd-orchestrator

tdd-orchestrator is a Claude Code skill that orchestrates test-driven development through red-green-refactor cycles. It coordinates multi-agent testing workflows and verifies test-first compliance.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · 51 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/development/tdd-orchestrator
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/tdd-orchestrator

## What it does

The skill enforces disciplined test-driven workflows across development tasks. It controls the red-green-refactor progression, catches test-after anti-patterns, and guides code changes from failing tests directly to minimal passing implementations.

Workflow guidance covers both classic Chicago style TDD and London mockist approaches. The agent delegates work across unit, integration, and contract test layers while coordinating advanced techniques such as property-based runs with Hypothesis or fast-check.

Legacy code characterization relies on golden master verification to preserve existing behavior during deep rewrites. Detailed step-by-step procedures reside in `resources/implementation-playbook.md`.

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --skill development/tdd-orchestrator
```

2. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill tdd-orchestrator -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/tdd-orchestrator/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/tdd-orchestrator/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill tdd-orchestrator -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/tdd-orchestrator/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill tdd-orchestrator -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/tdd-orchestrator/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davila7/claude-code-templates cli-tool/components/skills/development/tdd-orchestrator
```

2. **Manually: put the files in place**
- File: `.github/skills/tdd-orchestrator/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill tdd-orchestrator -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/development/tdd-orchestrator
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/tdd-orchestrator/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/development/tdd-orchestrator

## When to use it
- orchestrate disciplined red-green-refactor cycles when adding features
- delegate unit, integration, and end-to-end tests across specialized agents
- characterize legacy software using golden master tests before refactoring
- introduce property-based testing runs via Hypothesis or fast-check

## Example prompts
- Drive the payment service implementation using strict red-green-refactor cycles.
- Break down user authentication using classic Chicago TDD without unnecessary mocks.
- Create golden master characterization tests for the legacy report generator before refactoring.

## Similar
- [tdd](https://affpapa.org/en/nevibecode/skills/glebis-tdd.md) — skill · 262 installs
- [tdd-guide](https://affpapa.org/en/nevibecode/skills/alirezarezvani-tdd-guide.md) — skill · ★ 907 repo stars
- [tdd-red](https://affpapa.org/en/nevibecode/commands/tdd-red.md) — command · ★ 42780 repo stars
- [TDD Red Phase - Write Failing Tests First](https://affpapa.org/en/nevibecode/agents/tdd-red-phase-write-failing-tests-first.md) — subagent · ★ 41430 repo stars
- [backend-development-tdd-orchestrator](https://affpapa.org/en/nevibecode/agents/backend-development-tdd-orchestrator.md) — subagent · ★ 42780 repo stars
- [unit-testing-framework](https://affpapa.org/en/nevibecode/skills/unit-testing-framework.md) — skill · 633 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 745 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
