orchestrate

Orchestrate Command

Coordinate complex tasks through delegation to specialist agents.

Arguments

• --use-deep-dive: Use existing deep-dive context to skip or accelerate exploration phase
• <task description>: The task to orchestrate

How much of the pipeline runs is decided by the orchestrator, not by user flags — see Execution Profile.

State Initialization

FIRST: Initialize orchestration state by running:

# Check for --use-deep-dive flag
USE_DEEP_DIVE=false
TASK_ARGS="$ARGUMENTS"
if [[ "$ARGUMENTS" == *"--use-deep-dive"* ]]; then
  USE_DEEP_DIVE=true
  TASK_ARGS=$(echo "$ARGUMENTS" | sed 's/--use-deep-dive//' | xargs)
fi

bash ${CLAUDE_PLUGIN_ROOT}/scripts/init-orchestration.sh "$TASK_ARGS"

This creates .claude/orchestration.local.md to track:

• Current phase and iteration
• Gate results for each phase
• Agent actions and timestamps

Prompt Refinement (Pre-Phase)

Ticket intake: if "$ARGUMENTS" contains an issue key (e.g. ABC-123) or a Jira/Atlassian/GitHub-issue URL and a matching tool is available (e.g. getJiraIssue, gh issue view), fetch the ticket first and seed the intent from it — Goal from the summary, Constraints and acceptance criteria from the description/ACs, and keep the key in the Goal so branch, commit, and PR names can carry it. Lawliet's intent-fidelity check then compares against the real acceptance criteria. Skip silently when no tool is available.

Apply the prompt-refinement skill to "$ARGUMENTS": if scope is genuinely ambiguous ask ONE clarifying question (with options); otherwise state a reasonable assumption and structure the task as Goal / Description / Actions / Constraints / Assumptions. Then:

1. Classify task complexity using the task-classification skill tiers (Trivial / Exploratory / Implementation / Complex / Research). task_complexity is this tier, NOT complexipy code/cognitive complexity.

2. Detect explicit written-report request: independently of the tier, set REPORT_REQUESTED_FLAG to true only if the user explicitly asked for a written report, investigation guide, or planning document.