team-orchestrate

Team Orchestrate Command

Coordinate complex tasks through sequential delegation to specialist agents, with PARALLEL execution of Review + Verification phases using Agent Teams when available.

Arguments

• --use-deep-dive: Use existing deep-dive context to skip or accelerate exploration phase
• --force-sequential: Force sequential mode even if Agent Teams is available
• <task description>: The task to orchestrate

State Initialization

FIRST: Initialize team orchestration state by running:

# Parse flags from arguments
USE_DEEP_DIVE=false
FORCE_SEQUENTIAL=false
TASK_ARGS="$ARGUMENTS"

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

if [[ "$ARGUMENTS" == *"--force-sequential"* ]]; then
  FORCE_SEQUENTIAL=true
  TASK_ARGS=$(echo "$TASK_ARGS" | sed 's/--force-sequential//' | xargs)
fi

# Build init command
INIT_CMD="bash ${CLAUDE_PLUGIN_ROOT}/scripts/init-team-orchestration.sh"
[[ "$USE_DEEP_DIVE" == true ]] && INIT_CMD="$INIT_CMD --use-deep-dive"
[[ "$FORCE_SEQUENTIAL" == true ]] && INIT_CMD="$INIT_CMD --force-sequential"
INIT_CMD="$INIT_CMD $TASK_ARGS"

eval "$INIT_CMD"

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

• Current phase and iteration
• Orchestration mode (team vs sequential)
• Parallel group status (review_verification with sub-phases)
• Gate results for each phase
• Agent actions and timestamps

Prompt Refinement (Pre-Phase)

Before beginning orchestration, ensure the task is well-defined:

1. Check Task Clarity: Does "$ARGUMENTS" specify:

   • What needs to be changed?
   • Where in the codebase?
   • What problem it solves?

2. If Vague: Ask ONE clarifying question before proceeding

   • Provide options when possible
   • Reference prompt-refinement skill for guidance

3. If Clear: Transform into structured format:

   • Goal: One-sentence outcome
   • Description: What and why (2-3 sentences)
   • Actions: Concrete steps
   • Constraints: Non-negotiable limits
   • Assumptions: Things believed true that, if false, would change the approach