design-validation
Cross-check design artifacts for consistency and completeness. Use before implementation.
When & Why to Use This Skill
This Claude skill automates the validation of software design artifacts, ensuring consistency and completeness across specifications, architecture, and APIs before the implementation phase. By performing rigorous cross-checks, it helps development teams identify architectural gaps, logical contradictions, and security omissions early in the SDLC, significantly reducing technical debt and costly rework.
Use Cases
- Pre-implementation Audit: Cross-checking business requirements against technical architecture to ensure 100% coverage and traceability.
- API Consistency Verification: Ensuring that proposed API endpoints and data structures align perfectly with the defined architectural components.
- Test Plan Alignment: Verifying that the QA test plan addresses all acceptance criteria and functional requirements defined in the design phase.
- Security Compliance Check: Confirming that all mandatory security requirements are explicitly addressed within the design documents before coding begins.
- Gap Analysis: Identifying missing links between specifications and implementation plans to prevent 'scope creep' or missing features.
| name | design-validation |
|---|---|
| description | Cross-check design artifacts for consistency and completeness. Use before implementation. |
Design Validation
Verify that all design documents are consistent and complete before implementation begins.
Process
- Check spec → architecture coverage
- Check architecture → API consistency
- Verify test plan covers all requirements
- Confirm security requirements addressed
- Identify gaps or contradictions
Output
Create design-validation.md using the template in templates/design-validation.md.
Tips
- Every requirement should trace to architecture
- Every API should trace to architecture components
- Test plan should cover all acceptance criteria
- Flag ambiguities, don't assume
- Severity: Critical > Major > Minor