Agents yaakov@ytx.app

Parallel orchestration

Many minds,
one task.

Split the work. Run it all at once. Ship a stack.

Agent workflows take a large job — a design doc, a feature plan, a research question — and fan it out to specialized subagents running in parallel. Each worker gets an isolated git worktree, a scoped assignment, and a structured result to hand back to the orchestrator. Built for Claude Code agent teams.

orchestrator DAG 4 lanes active · topo-sorted

Capabilities

01 · Fan-out

DAG from a plan

A design document becomes a directed acyclic graph of PR-sized chunks. The orchestrator topologically sorts dependencies before anything runs — independent nodes launch together.

02 · Isolation

Worktree per agent

Each implementer works in its own git worktree — no stomping on shared files. Commits land as discrete SHAs the orchestrator fetches and assembles into a branch stack.

03 · Assembly

Stack + review

Branches stack in dependency order. Mandatory reviewer subagents run before merge-ready. Output is a Graphite PR chain, not a pile of loose diffs.

Worktree lanes

feature/auth-refactor · 4 worktrees stack depth: 3

Task board

feature/auth-refactor 3 running · 2 blocked · 1 review
Queued
AUTH-04
E2E smoke tests
blockeddeps: AUTH-02
AUTH-05
Docs + changelog
blockeddeps: AUTH-03
Running
AUTH-01
Research OAuth flows
agentwt/research
AUTH-02
Schema migration
agentwt/impl-a
Review
AUTH-03
Token refresh endpoint
reviewerwt/impl-b
Done
AUTH-00
Design doc parsed
mergedSHA a3f91c

How a job moves through it

1
Parse the planBreak a design doc into nodes with explicit depends-on edges and persona assignments — implementer, reviewer, verifier. Each node gets a scope, acceptance criteria, and a target worktree name.
2
Launch in parallelIndependent nodes spawn simultaneously as Claude Code agent teams. Blocked nodes wait on parent commits before their worktree is seeded — no race on shared state.
3
Review-fix loopEach node gets a reviewer subagent. Failures return to the implementer until the orchestrator marks the branch merge-ready. SHAs accumulate in the worktree lane.
4
Assemble the stackWorktrees tear down, branches fast-forward in dependency order, and PRs open — one coordinated Graphite stack instead of serial handoffs.

Coordination primitives

Three ways Claude Code composes agents — each maps to a different scope and lifecycle in the orchestrator.

Primitive Scope Lifecycle Best for
Subagent Single task, returns result to parent Spawn → execute → report → terminate Reviewer passes, focused research, one-shot codegen
Teammate Shared session, persistent context Join team → collaborate → hand off state Long-running implementers in parallel worktrees
Workflow Full DAG, orchestrator-owned Parse plan → topo-sort → fan-out → stack Design doc → multi-PR feature with dependency chain
⌂ DashboardDesign ·ClaudeCodexGrokGeminiDeepSeek