Validate architecture document completeness and quality against comprehensive checklist. Checks required sections, technology justifications, NFRs coverage, and generates quality score with actionable recommendations. Use after architecture creation to verify completeness, quality, and NFR coverage before implementation begins.
Validate architecture document completeness and quality against comprehensive checklist. Checks required sections, technology justifications, NFRs coverage, and generates quality score with actionable recommendations. Use after architecture creation to verify completeness, quality, and NFR coverage before implementation begins.
acceptance
[{"validation_complete":"All checklist items evaluated"},{"quality_score_calculated":"Quality score (0-100) computed"},{"gaps_identified":"Missing elements and gaps documented"},{"recommendations_provided":"Actionable recommendations given"}]
inputs
{"architecture_file":{"type":"string","required":true,"description":"Path to architecture document (docs/architecture.md)"},"project_type":{"type":"string","required":false,"description":"frontend | backend | fullstack (auto-detected if not provided)"},"strict_mode":{"type":"boolean","required":false,"description":"Enforce stricter validation criteria (default: false)"}}
outputs
{"validation_passed":{"type":"boolean","description":"Whether architecture passed validation (score ≥70)"},"quality_score":{"type":"number","description":"Overall quality score (0-100)"},"gaps":{"type":"array","description":"List of missing or incomplete elements"},"recommendations":{"type":"array","description":"Prioritized improvement recommendations"}}
Validate architecture documents for completeness, quality, and adherence to best practices. Generates comprehensive validation report with quality score, identified gaps, and prioritized recommendations for improvement.
Core Principles:
Comprehensive checklists: Cover all architectural dimensions
Completeness (sections): 30-40 points (varies by type)
Technology justifications: 15 points
NFR coverage: 15 points
ADRs quantity & quality: 15 points
Security posture: 10 points
Scalability planning: 10 points
Deployment strategy: 10 points
Quality Grades:
90-100: Excellent (A)
80-89: Good (B)
70-79: Acceptable (C)
60-69: Needs Improvement (D)
<60: Insufficient (F)
Validation passes if score ≥70
11. Identify Gaps
Categorize identified gaps:
Critical Gaps (blocking):
Missing security section
No technology justifications
Fewer than 3 ADRs
Zero NFR coverage
Major Gaps (important):
Missing key sections for project type
Poor ADR quality
Minimal security details
No scalability planning
Minor Gaps (nice-to-have):
Incomplete deployment details
Missing diagrams
Light monitoring discussion
Priority: Critical → Major → Minor
12. Generate Recommendations
Based on identified gaps, provide actionable recommendations:
Recommendation format:
**Priority:** Critical | Major | Minor
**Gap:** [Specific missing element]
**Recommendation:** [Concrete action to take]
**Impact:** [Why this matters]
**Effort:** [Estimated time to address]
Example:
**Priority:** Critical
**Gap:** Security architecture section missing
**Recommendation:** Add security architecture section covering authentication, authorization, encryption, and input validation
**Impact:** Security is fundamental for production readiness
**Effort:** 2-3 hours
See:references/templates.md for recommendation and report templates
