pan review

Manage the review pipeline for completed agent work. Use this when an issue
has been signaled done by the work agent but you need to inspect, retry, or
abandon the review pass. Review verdicts are PR reviews (approve or request
changes) — there is no separate pipeline status to list, reset, or resync;
gh pr list and gh pr view answer "what's waiting" directly from the forge.

Usage

pan review request <id>                            # Re-request review after fixing feedback
pan review abort <id>                               # Kill all running reviewers, leave worker idle
pan review restart <id> [--model <m>] [--role <r>]  # Resume review and re-dispatch reviewers missing a report

Review mode (quick vs full) has no per-issue override (PAN-3917: the
per-issue record it lived on is gone). It is project/global configuration —
roles.review.mode in config.yaml — resolved once per run by
resolveReviewMode() so manual requests, automatic dispatch, and recovery
all agree. quick runs one combined-pass review agent; full runs the
parent plus the four-lane convoy (security, correctness, performance,
requirements) in parallel. Edit the project's config.yaml and re-run
pan review request <id> (or let the next automatic dispatch pick it up) to
change it. See docs/REVIEW-AGENT-ARCHITECTURE.md "Review modes".

What each subcommand does

• request <id> — After fixing the issues a reviewer flagged, this
  re-triggers the review pipeline against the current branch state. Use this
  when the worker has committed fixes and you want the existing review pass
  to re-evaluate.
• abort <id> — Kills any currently running reviewer sessions but
  leaves the work agent alone. Use when reviewers are stuck or running
  against the wrong commit and you want to halt without waiting them out.
• restart <id> — Restarts the review parent, preserves completed reports,
  and re-dispatches reviewer lanes that have no report. Use when a reviewer
  crashed and the synthesis parent is waiting on that missing lane. Optional flags:
  • --model <model> — override the model for every reviewer in this run
    (e.g. gpt-5.4, claude-sonnet-4-6). Useful when the default model has
    misbehaved and you want to retry with a different one.
  • --role <role> — restart only one reviewer role (correctness,
    security, performance, requirements) instead of the whole convoy.

When to use each

Merging is NOT here

To merge an approved branch, use the MERGE button on the dashboard, or
gh pr merge. The merge agent runs autonomously once approvals and checks
are green and the PR is mergeable; humans only click the button.

See also

• pan show <id> — inspect work agent state, xBRIEF status, recent activity
• pan done <id> — signal initial work completion (from the worker side)
• pan-code-review skill — orchestrated parallel code review with synthesis
• roles/review.md — the review role's frontmatter and prompt
• docs/REVIEW-AGENT-ARCHITECTURE.md — full design of the review convoy