| name | plan-review |
| description | Use when scout-report.md exists and TDD/Build hasn't started yet. Runs four lenses (CEO, Eng, Design, Security) in parallel on the task list and produces a verdict (PROCEED, REVISE, ABORT) before code is written. Catches misaligned plans before they cost cycles. |
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 claude-tmux, tier deep, fan-out ×4 |
| Inputs | scout-report.md · triage-report.md |
| 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-reviewloop 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 templateslegacy/scripts/dispatch/aggregator.sh plan-review merge modelegacy/scripts/lifecycle/phase-gate.sh:gate_plan_review_to_tdddocs/architecture/tri-layer.md (anti-patterns)
