review-orchestrator

Unified Orchestrated Code Review

Detect changed files, enrich with git context, dispatch the right reviewer agents in parallel, collect and deduplicate findings.

Target

Parse the user's request to determine scope and parameters. Accepted formats:

• PR#NNN or a number — review a pull request
• A branch name — diff against that branch
• --full — review all tracked files
• Empty — default to HEAD~1

Step 1 — Detect Changed Files and Gather Context

Determine the diff base:

• If target matches PR#NNN or is a number: gh pr diff $TARGET --name-only
• If target is a branch name: git diff --name-only $TARGET...HEAD
• If target is --full: review all tracked files (git ls-files)
• If empty: git diff --name-only HEAD~1

Gather structured context for agent prompts:

# Changed files with line counts
git diff --stat ${BASE}...HEAD

# Full diff hunks (for agent context injection)
git diff ${BASE}...HEAD

# Recent 5 commits (for intent)
git log --oneline -5

Build a REVIEW_CONTEXT block:

=== REVIEW CONTEXT ===
## Changed Files (N files, +X/-Y lines)
<git diff --stat output>

## Recent Commits (intent)
<git log --oneline -5>

## Diff Hunks
<full diff, truncated to 8000 chars per agent if needed>
=== END CONTEXT ===

Step 2 — Map Files to Agents

Based on file extension and path patterns, build a dispatch plan. Each pattern maps to one or more agents:

File Pattern	Agents
*.go (excluding *_test.go, migrations/)	go-reviewer, security-scanner
migrations/*.sql or db/migrate/*.sql	migration-reviewer
*.tsx	ts-reviewer, design-system-reviewer
*.ts	ts-reviewer
*.py	py-reviewer, security-scanner
*.rs	rs-reviewer
**/bot*/**/*.go or **/bot*/**/*.py	bot-reviewer
*.yaml / *.yml (OpenAPI/config)	api-contract-sync (if available)

Rules:

• A single agent is dispatched at most once even if multiple files match
• Only dispatch agents that are actually available in the project's skills directory
• If no files match any pattern, report "No reviewable changes detected" and stop
• List the dispatch plan before executing (agent name + matched file count)