plan-review

Sprint 2 multi-lens review (v8.16+). Inspired by garrytan/gstack/autoplan. Default-off; enable via workflow.phase_enables.plan-review=on in policy.json.

When to invoke

• After Scout writes <workspace>/scout-report.md, before TDD/Build
• Whenever the cycle goal mentions architecture, sandbox, or kernel changes
• When the previous cycle aborted due to misaligned scope

When NOT to invoke

• Cycle is a documented retry of a previously-approved plan
• Single-line fix or trivial bug
• Eval-only cycles (no code change)

Workflow

Step	Action	Exit criteria
1	Verify <workspace>/scout-report.md exists + fresh	scout-report.md valid
2	Dispatch 4 lenses in parallel via subagent-run.sh dispatch-parallel plan-reviewer	4 worker artifacts
3	Aggregator computes verdict (PROCEED/REVISE/ABORT)	<workspace>/plan-review-report.md present, first line is Verdict: <X>
4	Phase gate gate_plan_review_to_tdd enforces verdict	Gate passes only on PROCEED

Verdict semantics

Verdict	Trigger	Orchestrator action
PROCEED	Avg score ≥ 7 AND no lens < 5	Advance to TDD
REVISE	Avg ≥ 5 AND any lens < 5	Re-run Scout (max 2 retries)
ABORT	Any lens explicit ABORT, OR avg < 5	End cycle

Report format

First line Verdict: <X>, second Average Score: <N.N>, then per-lens reports.

Phase facts

Fact	Value
Phase	plan-review (plan archetype, optional, gated by workflow.phase_enables.plan-review=on)
Persona	agents/plan-reviewer.md
Profile	.evolve/profiles/plan-reviewer.json — CLI codex-tmux, tier deep, fan-out ×4
Inputs	scout-report.md · triage-report.md · triage-decision.json
Artifact	plan-review-report.md (cycle workspace)

Output contract

plan-review-report.md — no required sections (classified by the phase runner).

Composition

Invoked by:

• /evo:plan-review
• loop macro (between Scout and TDD when workflow.phase_enables.plan-review=on)

The plan-reviewer persona uses parallel_subtasks (see .evolve/profiles/plan-reviewer.json) — the lens sub-personas (count projected into Phase facts above) run concurrently and merge via aggregator.sh phase=plan-review.

Reference

• .evolve/profiles/plan-reviewer.json for lens prompt templates
• legacy/scripts/dispatch/aggregator.sh plan-review merge mode
• legacy/scripts/lifecycle/phase-gate.sh:gate_plan_review_to_tdd
• docs/architecture/tri-layer.md (anti-patterns)