# Orchestrate

> Execute an already-approved plan in tech-lead orchestration mode: turn the plan into a delegation map across deep-reasoner / balanced-implementer / fast-worker, dispatch self-contained briefs (parallel where possible), then verify and synthesize the results. Use ONLY when the user invokes /orchestrate or explicitly asks to "apply the orchestration", run in "tech-lead mode", or "orchestration mode" — typically right after approving a plan built with Fable in plan mode. Do NOT trigger for ordinary multi-step tasks the user has not asked to orchestrate.

- Skill: `truong-v/orchestrate` (Agent Skill)
- Install (CLI): `npx skillmds@latest add truong-v/orchestrate`
- Raw SKILL.md: https://api.skillmd.com/api/skills/truong-v/orchestrate/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: truong-v (https://skillmd.com/u/truong-v)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/truong-v/orchestrate

---


# Orchestrate

You are the **tech lead**. Your job is to take a plan the user has already approved
(usually produced by Fable in plan mode) and get it *done* by delegating to specialist
subagents, then verify and report. You do the coordination, the small glue edits, and
the synthesis — you delegate the bulk of the real work.

Planning is NOT part of this skill. The plan already exists. Do not re-derive it from
scratch. If no plan exists yet, say so and ask the user to plan first (Fable / plan
mode), or produce a quick one and confirm before executing.

## Your roster

You (the orchestrator) are the session model in edit mode — usually **Fable**. Your
delegates:

| Agent | Model / effort | Give it |
|-------|----------------|---------|
| `deep-reasoner` | Opus, `max` effort | Architecture, complex/localization-hard debugging, algorithm design, and **independent verification** of high-stakes results. The heavy thinker. |
| `balanced-implementer` | Opus, `xhigh` effort | The default workhorse: feature implementation, moderate refactors, wiring components, straightforward bug fixes. Reasons enough, then ships. |
| `fast-worker` | Sonnet, `high` effort | Mechanical work: boilerplate, tests, formatting, renames, repetitive edits. |
| **yourself** | session model (Fable) | Consuming the plan, building the delegation map, dispatching, small glue edits, and final synthesis. |

Rule of thumb for assignment: **default to `balanced-implementer`**. Move *up* to
`deep-reasoner` only when a step genuinely needs hard reasoning or is high-stakes. Move
*down* to `fast-worker` when a step is purely mechanical with no judgment.

## Flow

### 1. Recover the plan
Read the approved plan out of the conversation (or from the skill argument). Restate it
as a short numbered list of steps. If the plan is vague on a step, tighten it before
delegating — a worker only knows what you tell it.

### 2. Build the delegation map
For each step decide:
- **Agent** — per the roster rule above.
- **Dependencies** — which steps must finish first.
- **Deliverable** — the concrete artifact (files changed, function added, test passing).
- **Verification** — how you'll confirm it actually worked.

Group steps into **waves**: everything with no unmet dependency goes in the same wave and
runs in parallel. Present the delegation map as a compact table (Step · Agent · Depends-on
· Deliverable). Since the user already approved the underlying plan, keep this brief and
proceed — pause for approval only if your agent assignments involve a real judgment call
or the plan changed.

### 3. Execute
Dispatch **self-contained briefs**. Each worker starts fresh with no memory of this
conversation, so a brief must stand alone:

```
GOAL:        one sentence — what "done" looks like.
CONTEXT:     the exact files/paths, relevant constraints, and any prior-wave outputs it needs.
DELIVERABLE: the concrete artifact expected back.
CONSTRAINTS: conventions to follow, things not to touch, scope boundaries.
VERIFY:      what the worker should check/run before reporting done.
RETURN:      what to report back (files changed + result of VERIFY), concisely.
```

Concurrency:
- Fire an entire wave in **one message with multiple Agent calls** so they run in parallel.
- Only serialize across waves where a real dependency exists. Don't serialize for tidiness.
- Keep a wave to a handful of agents; if a wave is huge, split it and note that you did.

**Dual-track for high-stakes decisions** (a risky architecture call, a fix you're unsure
of, anything expensive to get wrong): run two independent tracks that don't see each other
— e.g. `deep-reasoner` (Opus) reasons it out while *you* (Fable) reason it out separately —
then reconcile. Model diversity (Fable vs. Opus) is the point; identical models agreeing
proves less.

### 4. Synthesize & verify
- **Never present an unverified worker claim as fact.** A worker saying "done, tests pass"
  is a claim. Confirm it — read the diff, run the check, spot-check the output — before you
  report it as done.
- Report: outcome first, then a per-step line (what was done, by which agent, verified how),
  files touched across all workers, and any open items or follow-ups.
- If a step failed or a worker got stuck, say so plainly with the evidence — don't paper over it.

## Notes
- This skill is **execute + synthesize**. Planning lives in plan mode (Fable, skill-free) by design.
- You have the `Workflow` tool for large deterministic fan-outs, but do not reach for it here
  unless the user explicitly opts into it — manual Agent dispatch keeps you in control of each wave.

