Structured plan review with Phase 0 self-review, 5-phase code review (Architecture, Code Quality, Tests, Performance, Production Readiness), approval scope triage, decision logging, and blast radius assessment. Use when reviewing plans, PRs, or preparing non-trivial changes for implementation.
Structured review workflow for non-trivial changes. Covers planning discipline (Phase 0) and 5-phase technical review with severity triage, decision logging, and production readiness gates.
Ask the user which mode to use:
| Mode | When | Phases |
|---|---|---|
| Big Change | New features, architectural changes, multi-service work | Phase 0 + all 5 review sections (up to 4 issues each) |
| Small Change | Focused feature, single-service change | Phase 0 + top issue per section only |
| Review Only | PR review, existing code audit, refactor | Skip Phase 0 (lightweight outcome check only) + all 5 review sections |
Load references as needed per phase:
| Phase | Reference File | Contents |
|---|---|---|
| Core |
| reference/plan-mode-protocol.md |
| Approval scope triage, severity classification, Phase 0 gate requirements, multi-turn continuity, token limit triage |
| Phase 0 | reference/phase0-self-review.md | Outcome spec, 3 approaches, self-critique, deletion pass, gate check |
| Phase 5 | reference/production-readiness-gate.md | Blast radius, rollback strategy, dependency health, cost/infra impact, data migration, second-order effects |
| All phases | reference/review-interaction-protocol.md | Question format, decision log, visualization requirements, section pause protocol |
For Review Only mode: skip Phase 0 but run a lightweight outcome check — ask "Is this still the right thing to build/maintain? Has the original goal changed?"
Read reference/review-interaction-protocol.md for visualization and question format requirements.
Evaluate:
Generate a Mermaid or ASCII diagram of the current architecture BEFORE discussing issues.
Evaluate:
code-standards.md)For deep review, delegate to the code-reviewer agent with its checklist.
Evaluate:
Evaluate:
Generate an annotated request/data flow diagram showing timing or complexity.
| Need | Delegate to |
|---|---|
| Architecture Decision Records | architecture-decision-records skill |
| Deep security audit | security-reviewer agent |
| Database migration patterns | database-schema-designer skill |
| Code review checklist | code-reviewer agent |
| Tech debt / duplication | dedup-code-agent agent |
No plan provided: Ask the user to describe the change, paste the plan, or point to a PR/branch.
Scope unclear: Ask which mode (Big Change / Small Change / Review Only) and which phases to include.
Phase 0 gate fails: List which gate items are incomplete. Do NOT proceed — ask the user to resolve.
Cannot verify a claim: Mark as [UNVERIFIED — needs manual check] with the specific command or URL to verify. Never fabricate evidence.