plan-and-review

Plan and Review

Overview

Create implementation plans and validate them through automated review before execution. This skill combines the writing-plans methodology with plan-reviewer agent dispatch to catch quality issues (missing file paths, vague acceptance criteria, scope gaps, TDD omissions) before any code is written.

Announce at start: "I'm using the plan-and-review skill to create and validate the implementation plan."

Core principle: No plan reaches execution without passing review. Critical/High findings must be resolved first.

The 4 Phases

Phase 1: Create Plan → Phase 2: Review → Phase 3: Revise (if needed) → Phase 4: Approved

Phase 1: Create Plan

Use the writing-plans methodology to create the implementation plan.

1. Invoke the writing-plans skill (superpowers:writing-plans or equivalent)
2. Follow all writing-plans requirements:
   • Bite-sized tasks (2-5 minutes each)
   • Exact file paths for all changes
   • TDD structure (Red-Green-Refactor) for core logic
   • Complete code in plan (no placeholders)
   • Alternatives exploration for non-trivial decisions
3. Save plan to docs/plans/YYYY-MM-DD-<feature-name>.md

Phase 2: Dispatch Plan Reviewer

Dispatch the plan-reviewer agent as a subAgent to review the plan.

1. Dispatch plan-reviewer using the Agent tool:

   subagent_type: "general-purpose"
   prompt: |
     You are the Plan Reviewer agent. Review the implementation plan at
     docs/plans/<plan-file>.md against the original spec/issue.
   
     Review checklist:
     - File paths: All paths valid (Modify files exist, Create paths have valid parents)
     - Acceptance criteria: Specific, measurable, verifiable (no vague terms)
     - Scope alignment: Plan matches spec — no scope creep, no missing items
     - TDD compliance: Red-Green-Refactor for core logic tasks
     - Backward compatibility: Breaking changes documented with migration steps
   
     Output a severity-rated findings table:
     | Finding | Location | Severity | Recommendation |
   
     End with Review Summary showing counts per severity and verdict:
     APPROVED (Critical=0 AND High=0) or REVISE REQUIRED.
   

2. Collect the review results