architecture-validation

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Architecture Validation Skill

架构验证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
  • Dimensions - 验证范围(组件、依赖项、API等)
  • Workflow - 分步验证流程
  • Extraction Patterns - 如何从计划中提取架构元素
  • Compliance - 合规级别与报告格式
  • Self-Learning - 持续改进框架

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.
通用自适应框架,具备以下功能:
  • 发现
    plans/
    目录中的所有计划文件
  • 动态提取架构需求
  • 验证实现的合规性
  • 报告差异、漂移与违规情况
核心原则:与架构无关,适用于任何项目结构。

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 for detailed phases and dimensions.md for validation categories.
  1. 发现 - 查找所有计划文件
  2. 提取 - 提取架构元素
  3. 分析 - 与代码库进行对比
  4. 验证 - 检查合规性
  5. 差异分析 - 识别缺失、漂移或冗余内容
  6. 报告 - 生成综合报告
详细阶段请查看**workflow.md,验证分类请查看dimensions.md**。