# Architecture Validation

> Dynamically validate that the implemented codebase matches architectural decisions documented in plan files. Use when validating implementation matches planning documents, checking for architecture drift, or preparing for architecture reviews. Use when this capability is needed.

- Skill: `tomevault-io/architecture-validation` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/architecture-validation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/architecture-validation/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/architecture-validation

---


# Architecture Validation Skill

Dynamically validate that the implemented codebase matches architectural decisions documented in plan files.

## Quick Reference

- **[Dimensions](dimensions.md)** - What gets validated (components, dependencies, APIs, etc.)
- **[Workflow](workflow.md)** - Step-by-step validation process
- **[Extraction Patterns](extraction.md)** - How to extract architectural elements from plans
- **[Compliance](compliance.md)** - Compliance levels and report format
- **[Self-Learning](self-learning.md)** - 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

1. **Discover** - Find all plan files
2. **Extract** - Pull architectural elements
3. **Analyze** - Compare vs codebase
4. **Validate** - Check compliance
5. **Gap Analysis** - Identify missing/drift/extra
6. **Report** - Generate comprehensive report

See **[workflow.md](workflow.md)** for detailed phases and **[dimensions.md](dimensions.md)** for validation categories.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/d-o-hub) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->

