| name | review-spec |
| description | Review design specs for correctness, completeness, consistency, quality, implementability, and risks. Verifies claims against source code. Invoke with /review-spec <path-to-spec>. |
Design Spec Review
Review implementation design specs by verifying claims against source code and evaluating across six dimensions.
Quick Reference
Process:
- Read the spec and identify every verifiable claim
- Cross-reference claims against source code (line numbers, signatures, patterns)
- Check alignment with project standards (CLAUDE.md, existing conventions)
- Report findings by dimension, skip clean dimensions
Dimensions:
- Correctness: Are verifiable claims true? (line numbers, signatures, precedent citations)
- Completeness: Any gaps, missing scenarios, or unaddressed edge cases?
- Consistency: Does the design align with project standards and existing patterns?
- Quality: Latent defects, error-prone interfaces, fragile assumptions?
- Implementability: Can someone implement without ambiguity or unstated decisions?
- Risks: What could go wrong? (security, performance, rollback when relevant)
Output: Narrative findings by dimension, ending with a summary of substantive issues. Skip dimensions with nothing to report.
See reference.md for detailed standards.
