Parallel Execution

Overview

Execute multiple independent tasks simultaneously using multiple subagent invocations in a single message. Reduces implementation time by 50-80% for multi-component features.

Announce at start: "I'm using parallel-execution to run [N] independent tasks simultaneously."

The Process

Step 1: Identify Parallel Tasks

Check subtask JSON files for parallel: true:

bash .opencode/skills/task-management/router.sh parallel {feature}

Output shows which tasks can run together:

Batch 1 (Ready now):
- subtask_01.json (parallel: true)
- subtask_02.json (parallel: true)

Batch 2 (After Batch 1):
- subtask_03.json (depends_on: ["01", "02"])

Step 2: Execute Parallel Batch

Make multiple task() calls in SINGLE message:

I'll execute Batch 1 tasks in parallel:

task(
  subagent_type="CoderAgent",
  description="Execute subtask 01",
  prompt="Read .tmp/tasks/feature/subtask_01.json and implement..."
)

task(
  subagent_type="CoderAgent",
  description="Execute subtask 02",
  prompt="Read .tmp/tasks/feature/subtask_02.json and implement..."
)

CRITICAL: Both task() calls in SAME message, not separate messages.

Step 3: Wait for All to Complete

All tasks in batch must complete before proceeding to next batch.

Step 4: Verify Batch Completion

bash .opencode/skills/task-management/router.sh status {feature}

Check all tasks in batch marked status: "completed".

Step 5: Execute Next Batch

Once Batch 1 complete, proceed to Batch 2:

task(
  subagent_type="CoderAgent",
  description="Execute subtask 03",
  prompt="Read .tmp/tasks/feature/subtask_03.json and integrate..."
)

Example: Converting Multiple Files

I'll convert these 5 subagent files in parallel:

task(subagent_type="CoderAgent", description="Convert auth-agent",
     prompt="Convert .opencode/agent/subagents/auth-agent.md to new format...")