validate-architecture

Validate architecture.md documents against a comprehensive checklist and generate a quality report.

2|2|Updated Oct 28, 2025
One-click install
npx skills add https://github.com/adolfoaranaes12/BMAD-ENHANCED --skill validate-architecture-adolfoaranaes12
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: validate-architecture
Source: https://github.com/adolfoaranaes12/BMAD-ENHANCED/tree/main/.claude/skills/validate-architecture
Command: npx skills add https://github.com/adolfoaranaes12/BMAD-ENHANCED --skill validate-architecture-adolfoaranaes12

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires read_file, validation-rules, and includes references (resource) components.

What problem does it solve?

This Skill validates architecture documents against a comprehensive checklist, computes a quality score, identifies gaps, and provides actionable recommendations.

Core Features & Use Cases

  • Load architecture document
  • Detect project type and universal/universal sections
  • Run completeness, technology justification, NFR coverage checks
  • Produce a validation report and a quality score
  • Provide remediation recommendations

Quick Start

Validate docs/architecture.md and generate a validation report.

Frequently Asked Questions about validate-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate an architecture document against a quality checklist?

Architecture validation checks your documentation against a comprehensive checklist covering completeness, technology justification, NFR coverage, ADR quality, and security. Load your architecture.md file, and the Skill detects your project type, runs all validation rules, and outputs a quality score with actionable gaps and recommendations.

What does an architecture validation report include?

The validation report contains a quality_score, validation_passed status, identified gaps in your documentation, and specific remediation recommendations. It assesses whether your architecture document adequately covers non-functional requirements, architectural decision records, security posture, and technology choices.

Can I validate architecture documents for frontend, backend, and fullstack projects?

Yes, architecture validation works across frontend, backend, and fullstack projects. The Skill detects your project type automatically and applies universal validation sections alongside type-specific checks for completeness and technology justification.

What happens if my architecture document fails validation?

When validation fails, the report identifies specific gaps in your documentation—missing ADRs, incomplete NFR coverage, or inadequate security considerations. The Skill generates actionable recommendations to address each gap before you proceed with implementation.

Does architecture validation check for security considerations?

Yes, security posture is a core validation dimension. The Skill assesses whether your architecture document adequately addresses security requirements and provides recommendations to strengthen your security coverage.

How is the architecture quality score calculated?

The quality score derives from completeness checks, technology justification validation, NFR coverage assessment, ADR quality evaluation, and security considerations. Each dimension contributes to an overall score that reflects documentation maturity and readiness.