examples

Architecture validation checks your architecture.md file against a comprehensive checklist to identify missing sections, gaps in ADRs, NFRs, security considerations, and diagrams. It produces a structured report with a validation_passed verdict, quality_score, and prioritized recommendations to improve documentation quality.

The validation report contains a validation_passed boolean, a quality_score, identified gaps in required sections, and actionable recommendations ranked by priority. The score reflects completeness of architecture sections, diagrams, decision records, and non-functional requirements coverage.

Yes, architecture validation applies to frontend, backend, and fullstack projects. It analyzes the docs/architecture.md file format regardless of project type, extracting and validating the same structural components and requirements across all architectures.

The validator extracts and checks for architecture sections including ADRs (Architecture Decision Records), NFRs (Non-Functional Requirements), security considerations, diagrams, and overall document structure to ensure completeness and quality standards.

This Skill provides example validation outputs demonstrating both PASS and FAIL scenarios, showing the exact format of validation reports, scoring results, and recommendation structures so you can understand expected outputs before validating your own architecture documents.