paul-review

name	paul-review
description	Run thorough code review via REV subagent — spawns an isolated reviewer with fresh context for unbiased, senior-dev-level review across 8 dimensions.

PAUL Review

Run an on-demand REV review by dispatching an isolated code-reviewer subagent.

Canonical references

• ../references/review-prompt.md
• ../references/review-checklist.md

Default output

• Concise by default: show scope, reviewer dispatch status, findings summary, verdict, and one next action.
• Expand for critical/high findings, unavailable subagent support, oversized diffs, degraded review mode, or user request.

Command-local notes

• Read .paul/STATE.md and pals.json (modules.rev.enabled, model, pr_review, blocking settings).
• Ask for one review scope: current plan changes, specific files, branch vs base, or uncommitted changes; map scope using review-prompt.md.
• Assemble diff, changed files, optional AGENTS.md, and related *.test.* / *.spec.* files.
• Dispatch Agent({ subagent_type: "code-reviewer", run_in_background: false }); pass modules.rev.model when configured.
• Review dimensions stay in the referenced checklist: correctness, edge cases, naming, architecture, performance, security, test coverage, rollback safety.
• If Agent is unavailable, offer skip or degraded in-session review; label degraded mode clearly.
• Preserve structured findings with severity, location, suggestion, strengths, and verdict: READY, READY WITH CONCERNS, or NOT READY.
• On-demand only — NOT a lifecycle hook; REV does not fire automatically during PLAN/APPLY/UNIFY.