| name | paw-spec-review |
| description | Specification review skill for PAW workflow. Validates Spec.md against quality criteria and returns structured feedback for iteration. |
Spec 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 specifications for quality, completeness, and clarity before planning proceeds. Return structured feedback—do not make orchestration decisions.
Reference: Follow Core Implementation Principles from paw-workflow skill.
Capabilities
- Review Spec.md for quality, completeness, and clarity
- Validate against specification quality criteria
- Identify specific sections needing revision
- Return structured feedback with pass/fail status
Desired End State
After review, the PAW agent receives:
- Pass/fail determination
- For passing specs: confirmation of readiness for planning (with optional polish suggestions)
- For failing specs: specific issues by criterion, affected sections, and suggestions for fixing
Review Process
Evaluate the specification at .paw/work/<work-id>/Spec.md against the Quality Criteria Checklist below. For failing items, note the specific issue, identify affected section(s), and suggest what needs to change without prescribing exact wording.
Quality Criteria Checklist
Content Quality