execution-orchestrator

Execution Orchestrator - Smart Hybrid Dispatch

Executes the task plan generated by the task-router by spawning agents with the right models, collecting results, and coordinating integration.

When to Activate

• Called by task-router after generating an execution plan
• When re-executing after a conflict resolution

Core Principle

Each agent is self-contained. When spawning an agent via the Agent tool:

• Include ALL context the agent needs in its prompt
• Include the Index-First Protocol
• Include relevant skill guidance
• Include the specific files/symbols to work on
• Include expected output format
• Include context carry-forward from previous task (if applicable, see below)
• The agent should be able to complete its subtask with ZERO additional context

Context Carry-Forward

Before dispatching agents, check if context from the previous task can reduce re-reading:

1. Read the last entry in .claude/crew-history.json
2. Check if the previous task's filesModified overlaps with the current task's focus files
3. If overlap exists AND the previous task was recent (same session):
   • Include a "Previous Context" section in the agent prompt (max 500 tokens):

     ## Previous Task Context
     The previous task ("{task description}") modified these overlapping files:
     - {file}: {summary of what changed}
     Key decisions: {summary field from history}
     

   • This helps agents understand recent changes without re-reading unchanged sections
4. If no overlap or no recent history: skip this section

Token budget: Max 500 tokens for carry-forward context. If the previous summary is longer, condense to the most relevant parts for the current task's scope.

Execution Modes

Sequential Execution

For dependent subtasks where output of one feeds into the next:

Phase 1: Agent A completes → result
Phase 2: Agent B receives result + its task → completes → result
Phase 3: Agent C receives combined results → completes

Implementation:

1. Spawn Agent A, wait for result
2. Include Agent A's result summary in Agent B's prompt
3. Spawn Agent B, wait for result
4. Continue chain