Dispatching Parallel Agents — automate task assignment

Manages the mechanics of launching multiple agents in parallel without manual file-conflict checking.

When to use

• The plan lists multiple implementation steps with non-overlapping file sets.
• The Conductor or Orchestrator wants to parallelize those steps.
• You need to validate that parallel execution won't cause merge conflicts.

Workflow

Input

A plan with steps like:

## Step 1: Add GeminiProvider class
Files: Blaze.LlmGateway.Infrastructure/Providers/GeminiProvider.cs (create)

## Step 2: Add GeminiProvider tests
Files: Blaze.LlmGateway.Tests/Providers/GeminiProviderTests.cs (create)

## Step 3: Wire GeminiProvider in AppHost
Files: Blaze.LlmGateway.AppHost/Program.cs (edit)

Analysis

1. Extract file sets from each step.
2. Check for conflicts: Do any two steps touch the same file? If yes, they must be sequential.
3. Topologically sort: Group non-conflicting steps into "phases."
4. Assign to agents: Phase 1 step 1 → Coder (git worktree A), Phase 1 step 2 → Tester (worktree B), etc.

Output

For Phase 1 (parallel):

yaml
1# Handoff 1: Conductor → Coder (worktree A)
2files you may edit:
3  - Blaze.LlmGateway.Infrastructure/Providers/GeminiProvider.cs (create)
4files other parallel tasks own:
5  - Blaze.LlmGateway.Tests/Providers/GeminiProviderTests.cs (Tester)
6  - Blaze.LlmGateway.AppHost/Program.cs (Infra, Phase 2)

yaml
1# Handoff 2: Conductor → Tester (worktree B)
2files you may edit:
3  - Blaze.LlmGateway.Tests/Providers/GeminiProviderTests.cs (create)
4files other parallel tasks own:
5  - Blaze.LlmGateway.Infrastructure/Providers/GeminiProvider.cs (Coder)
6  - Blaze.LlmGateway.AppHost/Program.cs (Infra, Phase 2)

Both execute in parallel. When done, Phase 2 starts (Infra depends on both).

Key invariants

• No file overlap within a phase (verified automatically).
• Dependencies explicit (serial phase → parallel phases → serial phase, etc.).
• Each agent owns an exclusive worktree (via Codex-devfleet).
• Quality gate applies to every parallel merge (all must pass -warnaserror + 95% coverage).

See also

• team-builder — decompose tasks into parallel streams (manual).
• Codex-devfleet — Git worktree isolation (execution).
• quality-gate — validate parallel merges before advancing phases.