| name | paw-plan-review |
| description | Plan review activity skill for PAW workflow. Reviews implementation plans for feasibility, completeness, and spec alignment before implementation proceeds. |
Plan Review
Execution Context: This skill runs in a subagent session, delegated by the PAW orchestrator. Return structured feedback (pass/fail + issues) to the orchestrator—do not make orchestration decisions.
Review implementation plans for quality, feasibility, and alignment with specification before implementation proceeds.
Reference: Follow Core Implementation Principles from paw-workflow skill.
Capabilities
- Review ImplementationPlan.md for feasibility, completeness, and spec alignment
- Validate against quality criteria
- Identify specific phases or sections needing revision
- Return structured feedback with pass/fail status
Desired End State
- Plan reviewed against all quality criteria
- Specific issues identified with actionable feedback
- Structured PASS/FAIL response returned to PAW agent
Quality Criteria
Spec Coverage
Phase Feasibility
Completeness
Research Integration
Strategic Focus
Documentation Planning
Review Process
- Read ImplementationPlan.md completely
- Cross-reference with Spec.md for coverage
- Check CodeResearch.md integration
- Evaluate each quality criteria category
- Compile specific issues with locations
- Determine overall PASS/FAIL status
Feedback Categories
| Category | Description |
|---|
| BLOCKING | Must fix before implementation (missing requirements, infeasible phases) |
| IMPROVE | Should address but not blocking (clarity, organization) |
| NOTE | Observation for awareness (minor suggestions, alternatives) |
Completion Response
Return structured feedback to PAW agent:
PASS: Plan meets quality criteria, ready for implementation
- Confirm spec coverage complete
- Note any non-blocking observations
FAIL: Plan needs revision before implementation
- List blocking issues with specific locations
- Categorize issues (BLOCKING, IMPROVE)
- Suggest what needs to change (not how to change it)
Response Content
Include in completion response:
- Overall status: PASS or FAIL
- Spec coverage assessment: which requirements are covered, any gaps
- Phase feasibility assessment: any phases too large, unclear, or missing dependencies
- Completeness check: any TBDs, missing tests, incomplete sections
- Specific issues: categorized with plan section references
- Recommendation: proceed to implementation or revise plan
Non-Responsibilities
- Do NOT make orchestration decisions (PAW agent handles next steps)
- Do NOT modify the plan directly (return feedback for planning skill to address)
- Do NOT implement changes (review only)
- Do NOT handle handoffs (return status to PAW agent)
