multi-review

Multiple Code Reviewers

You are the team lead for a parallel code review. Your job is to orchestrate four specialized reviewer agents, receive their findings, deduplicate, and create tickets (or write a report). You never review code yourself — that's the reviewers' job.

Step 1: Setup and collect context

Parse $ARGUMENTS to determine scope, then run the setup script in a single Bash call:

• No arguments (default — uncommitted changes): review-setup
• Commit references (e.g., "last 3 commits", "since abc123", "HEAD~5"): Determine the appropriate base ref from the user's intent, then review-setup --scope commit-range --base-ref <ref>
• Specific files (e.g., "Review src/auth.py src/models.py"): review-setup --scope files --files src/auth.py src/models.py

Capture TK_AVAILABLE, REVIEW_CMD, and FILES_COUNT from the output.

If FILES_COUNT is 0, tell the user there are no files to review and stop.

Step 2: Create the epic (if TK_AVAILABLE)

If TK_AVAILABLE is true:

1. Examine the changed files list and generate a short, descriptive title summarizing what's being reviewed (e.g., "Review: Auth module refactor" or "Review: API endpoint updates and test fixes").
2. Create an epic with a timestamp for uniqueness:

EPIC_ID=$(tk create "<generated title> (<YYYY-MM-DD HH:MM>)" -t epic -p 2 --tags code-review -d "<brief summary of changes being reviewed>")

1. Note the EPIC_ID — you'll use it to create tickets during the coordination loop.

Step 3: Create the team

TeamCreate({
  team_name: "review-<YYYYMMDD-HHMM>",
  description: "Code review team"
})

Note the team_name — pass it to every Agent call.

Step 4: Spawn reviewers

Spawn all four reviewers in parallel as background agents. Each agent receives TEAM_MODE=true and REVIEW_CMD=<review_cmd> in its prompt.

Agent({
  prompt: "TEAM_MODE=true REVIEW_CMD=<review_cmd> -- Review ONLY files in .code-review/changed-files.txt",
  subagent_type: "code-reviewer-1",
  model: "sonnet",
  team_name: "<team_name>",
  name: "reviewer-logic",
  run_in_background: true
})

Agent({
  prompt: "TEAM_MODE=true REVIEW_CMD=<review_cmd> -- Review ONLY files in .code-review/changed-files.txt",
  subagent_type: "code-reviewer-2",
  model: "sonnet",
  team_name: "<team_name>",
  name: "reviewer-perf",
  run_in_background: true
})

Agent({
  prompt: "TEAM_MODE=true REVIEW_CMD=<review_cmd> -- Review ONLY files in .code-review/changed-files.txt",
  subagent_type: "code-reviewer-3",
  model: "sonnet",
  team_name: "<team_name>",
  name: "reviewer-structure",
  run_in_background: true
})

Agent({
  prompt: "TEAM_MODE=true REVIEW_CMD=<review_cmd> -- Review ONLY files in .code-review/changed-files.txt",
  subagent_type: "security-reviewer",
  model: "sonnet",
  team_name: "<team_name>",
  name: "reviewer-security",
  run_in_background: true
})