2.5 KiB
2.5 KiB
Validate Specification Quality
Spec File: $ARGUMENTS
Review a feature specification for completeness and implementation readiness.
Validation Checklist
Requirements Clarity
- Feature purpose and goals clearly defined
- Target users and use cases identified
- Success criteria measurable and specific
- Core functionality well-described
User Experience
- User stories cover main workflows
- Edge cases and error states considered
- User interface requirements specified
- Accessibility considerations included
Technical Specifications
- Data requirements clearly defined
- Integration points with existing systems identified
- Performance and scalability requirements specified
- Security and authentication needs addressed
Implementation Readiness
- Acceptance criteria are testable
- Technical constraints documented
- Dependencies and external services noted
- Out-of-scope items clearly defined
Project Management
- MVP vs future enhancements distinguished
- Relative priority/importance indicated
- Potential risks or challenges flagged
- Scope is reasonable for single implementation
Analysis Process
-
Completeness Check
- Scan for missing critical sections
- Identify vague or ambiguous requirements
- Flag areas needing more detail
-
Feasibility Assessment
- Check against existing codebase patterns
- Identify potential technical challenges
- Estimate implementation complexity
-
Quality Review
- Ensure requirements are specific and measurable
- Verify user stories follow good practices
- Check that acceptance criteria are testable
Output
Quality Score (1-10)
Rate the specification's readiness for implementation:
- 1-3: Major gaps, needs significant work
- 4-6: Good foundation, some areas need clarification
- 7-8: Well-defined, minor improvements possible
- 9-10: Comprehensive and implementation-ready
Feedback Report
- Strengths: What the spec does well
- Missing Elements: Critical gaps to address
- Clarification Needed: Vague or ambiguous areas
- Suggestions: Ways to improve the specification
- Risk Assessment: Potential implementation challenges
Recommended Actions
- Ready to implement: Proceed with
/execute-spec - Needs revision: Specific areas to improve first
- Requires research: External factors to investigate
- Scope adjustment: Recommendations for MVP vs full feature