| name | subagent-review |
| description | Runs detect_subagents then run_subagent (codex/gemini) in review mode via subagent-orchestrator MCP, reads .agent-runs outputs, and summarizes findings. Use when the user asks for external CLI review, codex/gemini review, subagent panel, tie-breaker, or invokes /check-subagents, /run-codex-review, /run-gemini-review, /run-subagent-review. |
Subagent review (MCP)
Run external CLI coding agents through the subagent-orchestrator MCP server — not by spawning codex / gemini / claude directly in the terminal.
Prerequisites
- Sibling checkout:
../subagent-orchestrator/agent-orchestrator built (npm install && npm run build there once)
- MCP server enabled in
.cursor/mcp.json as cli-review (or user-level subagent-orchestrator) and reloaded in Cursor
Step 1 — Resolve MCP server
Before CallMcpTool, find the enabled server where serverName is subagent-orchestrator (project key cli-review; user-level keys may also appear). Read tool schemas from mcps/*/tools/detect_subagents.json and run_subagent.json. Prefer the project server so WORKSPACE_ROOT is this repo.
Step 2 — Detect
Call detect_subagents (no arguments). Present a short table:
Note: Claude is detection-only in v0.1 — do not rely on it for live run_subagent.
Step 3 — Build request
- task — clear review goal (from user or slash command text)
- files — workspace-relative paths from
@ mentions (max 20; no .env, keys, binaries)
- mode —
review (default) or tie-breaker when comparing opinions
- allowWrites — always
false
- dryRun —
true when user says “dry run” or you are validating setup
Step 4 — Run
Call run_subagent with JSON per references/mcp-tools.md.
For a “panel” (user wants both agents): run sequentially — codex then gemini (or vice versa) with the same task and files. There is no run_subagent_panel tool in v0.1.
Step 5 — Read results
- Parse MCP response (
outputFile, summary, ok, error).
- Read
.agent-runs/.../stdout.md at the returned path.
- Summarize for the user:
## External review summary
### Verdict
### Findings (blocker | high | medium | low | nit)
### Suggested changes
### Agent agreement (if multiple runs)
### Next steps
Do not apply patches unless the user explicitly asks.
image-scoring-backend
- Suggest files from
git diff --name-only under modules/, tests/, migrations/, frontend/src/ when the user did not @ paths.
- Cross-repo changes: review this workspace only; open image-scoring-gallery separately for gallery diffs (v0.1 cannot span both roots in one MCP call).
- Safety: .agent/SAFETY.md
Errors
| Situation | Action |
|---|
| Agent not on PATH | Report detect_subagents notes; suggest install/auth |
allowWrites rejected | Explain v0.1 is review-only |
| Claude run requested | Use Codex or Gemini instead |
| MCP server missing | docs/technical/EXTERNAL_CLI_REVIEWS.md; build sibling orchestrator |
Related
- Rule:
external-cli-subagents.mdc
- Commands:
/check-subagents, /run-codex-review, /run-gemini-review, /run-subagent-review
- Orchestrator package:
../subagent-orchestrator/agent-orchestrator/README.md
