subagent-driven-development

name	subagent-driven-development
description	Dispatch multiple specialized subagents to work in parallel on independent tasks using git worktrees to prevent conflicts. Use when a plan has 3+ independent tasks or total work >2h. Triggers when BUILD workflow runs a multi-task plan.
allowed-tools	Read Write Bash

Subagent-Driven Development

Use when: plan has multiple independent tasks that can be parallelized.

When to Dispatch vs Do Inline

Dispatch when:

• Tasks touch different files (no conflicts possible)
• Tasks are independent (B doesn't depend on A's output)
• Each task is >30min
• 3+ tasks total in the plan

Do inline when:

• Tasks are sequential (B needs A's output)
• Tasks are <30min each
• Tasks share files (git conflicts)
• Only 1-2 tasks total

Dispatch Protocol

1. Prepare worktrees

git worktree add .git/worktrees/ohc-task-1 -b ohc/task-1
git worktree add .git/worktrees/ohc-task-2 -b ohc/task-2

2. Write task spec per subagent

Save to .ohc/state/dispatch-{id}.json:

{
  "task": "Task name from plan",
  "agent": "executor",
  "worktree": ".git/worktrees/ohc-task-1",
  "files": ["src/auth.ts", "tests/auth.test.ts"],
  "success_criterion": "All auth tests pass",
  "plan_ref": ".ohc/plans/auth-feature.md#task-1"
}

3. Launch

ohc team 3:claude "implement tasks from .ohc/state/dispatch-*.json"

Or: /ohc-team 3:executor in Claude Code with task specs attached.

4. Merge results

git merge ohc/task-1 ohc/task-2 ohc/task-3

Run verifier on merged result.

5. Cleanup

git worktree remove .git/worktrees/ohc-task-1
git branch -d ohc/task-1

See references/dispatch-patterns.md for when to dispatch. See references/worktree-coordination.md for conflict prevention.