architecture-validation

アーキテクチャ検証スキル

計画ファイルに記載されたアーキテクチャ上の決定に、実装されたコードベースが一致しているかを動的に検証します。

クイックリファレンス

• 検証項目 - 検証対象（コンポーネント、依存関係、API など）
• ワークフロー - 検証プロセスの手順
• 抽出パターン - 計画からアーキテクチャ要素を抽出する方法
• 準拠度 - 準拠レベルとレポート形式
• 自己学習 - 継続的改善フレームワーク

目的

次の機能を備えた汎用的で適応性の高いフレームワークです。

• plans/ ディレクトリ内のすべての計画ファイルを検出します
• アーキテクチャ要件を動的に抽出します
• 実装の準拠状況を検証します
• ギャップ、乖離、違反を報告します

重要な原則：特定のアーキテクチャに依存しないこと。あらゆるプロジェクト構成に対応します。

使用する場面

• 実装が計画ドキュメントに一致しているか検証するとき
• 開発後にアーキテクチャの乖離を確認するとき
• 設計上の決定が守られているか確認するとき
• 未実装の機能を特定するとき
• アーキテクチャレビューの準備をするとき
• リファクタリングによって境界が壊れていないか検証するとき

検証ワークフロー

1. 検出 - すべての計画ファイルを見つけます
2. 抽出 - アーキテクチャ要素を抽出します
3. 分析 - コードベースと比較します
4. 検証 - 準拠状況を確認します
5. ギャップ分析 - 不足、乖離、余分な要素を特定します
6. レポート - 包括的なレポートを生成します

各フェーズの詳細は workflow.md を、検証カテゴリの詳細は dimensions.md を参照してください。