アーキテクチャレビュー

プロジェクト構造を分析、監査、改善します。

主要原則

• 変更前に測定する — 構造をマップして具体的な問題を特定してから、変更を提案する
• 明確な境界 — UI、ロジック、データなどのレイヤーを分離し、一貫した依存方向を保つ
• コロケーション — 関連するコードを同じ場所に配置し、機能を容易に検索・変更・削除できるようにする
• 段階的マイグレーション — 段階的にリファクタリングし、各ステップをテストで検証する

クイック評価

• 循環依存がない
• 一貫性のあるディレクトリ命名とグループ化（機能別またはタイプ別）
• ファイル/モジュールごとに単一責任、妥当なファイルサイズ（500行未満）
• 外部依存関係は隔離され、共有コードが適切に抽出されている
• 新しい開発者が簡単にコードを探索でき、任意の機能のコードを見つけられる

クイックスタートチェックリスト

1. 現在の構造をマップする：ディレクトリツリー、依存グラフ、モジュール境界
2. 問題を特定する：循環依存、ゴッドモジュール、抽象化の漏洩、深いネスト
3. 重大度を分類する：緊急（開発を阻害）、高（保守負担）、中/低（摩擦）
4. ターゲット構造とマイグレーション計画を提案する
5. 段階的に実行し、各移動後にテストで検証する

...