Agents Playbook
Prompts

Slash Command — /review

Multi-agent code review pass on a PR (or current branch).

Slash Command — /review

Multi-agent code review pass on a PR (or current branch).

Trigger

/review [<pr#>]
  • /review — reviews the current branch's diff against main.
  • /review 1234 — reviews PR #1234.

Body

Run a multi-agent code review.

Process:

1. CONTEXT
   - If pr# given: fetch the PR description, intent manifest, linked issues.
   - Else: derive diff from `git diff origin/main..HEAD`.
   - Read CLAUDE.md / AGENTS.md.

2. PRE-CHECKS (orchestrator, fast)
   - Manifest present? If not: BLOCKING.
   - Intent claims match diff? (run check-pr-intent gate)
   - Gates green on the branch? (run `pnpm check:quality-gates`)

3. SPAWN SUB-AGENTS IN PARALLEL
   - `subagent-code-reviewer` — general review pass.
   - `subagent-code-reviewer` with security focus, OR a dedicated security review using `system-security` system prompt — if the diff touches auth / vault / audit / egress / sandbox.
   - `subagent-explore` — verify-first close: is the linked issue still open? Are peers touching same paths?

4. AGGREGATE
   - Merge findings; deduplicate.
   - Sort by severity, then confidence.
   - Drop findings < 0.6 confidence.

5. OUTPUT
   ## Verdict
   BLOCKING | APPROVE-WITH-CHANGES | APPROVE.

   ## Pre-checks
   - Manifest: present | missing
   - Intent vs diff: match | mismatch (details)
   - Gates: green | red (details)
   - Concurrent agents: clear | conflict (details)
   - Linked issue: open | closed (concern: dup PR)

   ## Findings (sectioned by severity)
   per finding: file:line + problem + suggested fix.

   ## Nits

   ## Praise (max 3 lines)

6. ON BLOCKING
   - Do NOT merge.
   - Surface the verdict to the user.
   - Suggest the smallest set of changes that would flip to APPROVE.

7. ON APPROVE
   - State the verdict.
   - DO NOT auto-merge unless the user explicitly approved merging in this session.
   - "/review" produces a verdict; merging is a separate, confirmed action.

Honesty:
- If the diff is too big to review well in one pass, say so. Recommend phase split.
- If you skipped a check, say so.
- No optimistic verdict.

Common failure modes

  • /review auto-merges. Side-effect without confirmation. → Body's Rule 7 separates verdict from merge.
  • Reviews dump every nit; reviewer drowns. → Confidence ≥ 0.6 filter.
  • Reviews skip security on touchy diffs. → Body's Rule 3 mandates security pass on sensitive paths.

See also