Architecture Validation Skill
Dynamically validate that the implemented codebase matches architectural decisions documented in plan files.
Quick Reference
- Dimensions - What gets validated (components, dependencies, APIs, etc.)
- Workflow - Step-by-step validation process
- Extraction Patterns - How to extract architectural elements from plans
- Compliance - Compliance levels and report format
- Self-Learning - Continuous improvement framework
Purpose
Generic, adaptive framework that:
- Discovers all plan files in
plans/directory - Extracts architectural requirements dynamically
- Validates implementation compliance
- Reports gaps, drift, and violations
Key Principle: Be architecture-agnostic. Work with ANY project structure.
When to Use
- Validating implementation matches planning documents
- Checking for architecture drift after development
- Ensuring design decisions are followed
- Identifying missing implementations
- Preparing for architecture reviews
- Verifying refactoring didn't break boundaries
Validation Workflow
- Discover - Find all plan files
- Extract - Pull architectural elements
- Analyze - Compare vs codebase
- Validate - Check compliance
- Gap Analysis - Identify missing/drift/extra
- Report - Generate comprehensive report
See workflow.md for detailed phases and dimensions.md for validation categories.