Initial commit

commands/analyze-dependencies.md

@@ -0,0 +1,158 @@
+## Dependency Analysis
+
+プロジェクトの依存関係を分析し、アーキテクチャの健全性を評価します。
+
+### 使い方
+
+```bash
+/dependency-analysis [オプション]
+```
+
+### オプション
+
+- `--visual` : 依存関係を視覚的に表示
+- `--circular` : 循環依存のみを検出
+- `--depth <数値>` : 分析の深さを指定 (デフォルト: 3)
+- `--focus <パス>` : 特定のモジュール/ディレクトリに焦点
+
+### 基本例
+
+```bash
+# プロジェクト全体の依存関係分析
+/dependency-analysis
+
+# 循環依存の検出
+/dependency-analysis --circular
+
+# 特定モジュールの詳細分析
+/dependency-analysis --focus src/core --depth 5
+```
+
+### 分析項目
+
+#### 1. 依存関係マトリックス
+
+モジュール間の依存関係を数値化して表示：
+
+- 直接依存
+- 間接依存
+- 依存の深さ
+- ファンイン/ファンアウト
+
+#### 2. アーキテクチャ違反検出
+
+- レイヤー違反 (下位層が上位層に依存)
+- 循環依存
+- 過度な結合 (高い依存度)
+- 孤立したモジュール
+
+#### 3. Clean Architecture 準拠チェック
+
+- ドメイン層の独立性
+- インフラ層の適切な分離
+- ユースケース層の依存方向
+- インターフェースの適用状況
+
+### 出力例
+
+```text
+依存関係分析レポート
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📊 メトリクス概要
+├─ 総モジュール数: 42
+├─ 平均依存数: 3.2
+├─ 最大依存深度: 5
+└─ 循環依存: 2 件検出
+
+⚠️  アーキテクチャ違反
+├─ [HIGH] src/domain/user.js → src/infra/database.js
+│  └─ ドメイン層がインフラ層に直接依存
+├─ [MED] src/api/auth.js ⟲ src/services/user.js
+│  └─ 循環依存を検出
+└─ [LOW] src/utils/helper.js → 12 modules
+   └─ 過度なファンアウト
+
+✅ 推奨アクション
+1. UserRepository インターフェースを導入
+2. 認証サービスの責務を再設計
+3. ヘルパー関数を機能別に分割
+
+📈 依存関係グラフ
+[視覚的な依存関係図を ASCII アートで表示]
+```
+
+### 高度な使用例
+
+```bash
+# CI/CD パイプラインでの自動チェック
+/dependency-analysis --circular --fail-on-violation
+
+# アーキテクチャルールの定義と検証
+/dependency-analysis --rules .architecture-rules.yml
+
+# 時系列での依存関係の変化を追跡
+/dependency-analysis --compare HEAD~10
+```
+
+### 設定ファイル例 (.dependency-analysis.yml)
+
+```yaml
+rules:
+  - name: "Domain Independence"
+    source: "src/domain/**"
+    forbidden: ["src/infra/**", "src/api/**"]
+
+  - name: "API Layer Dependencies"
+    source: "src/api/**"
+    allowed: ["src/domain/**", "src/application/**"]
+    forbidden: ["src/infra/**"]
+
+thresholds:
+  max_dependencies: 8
+  max_depth: 4
+  coupling_threshold: 0.7
+
+ignore:
+  - "**/test/**"
+  - "**/mocks/**"
+```
+
+### 統合ツール
+
+- `madge` : JavaScript/TypeScript の依存関係可視化
+- `dep-cruiser` : 依存関係のルール検証
+- `nx` : モノレポの依存関係管理
+- `plato` : 複雑度と依存関係の統合分析
+
+### Claude との連携
+
+```bash
+# package.json を含めた分析
+cat package.json
+/analyze-dependencies
+「このプロジェクトの依存関係の問題点を分析して」
+
+# 特定モジュールのソースコードと組み合わせ
+ls -la src/core/
+/analyze-dependencies --focus src/core
+「コアモジュールの依存関係を詳細に評価して」
+
+# アーキテクチャドキュメントとの比較
+cat docs/architecture.md
+/analyze-dependencies --visual
+「設計ドキュメントと実装の乖離を確認して」
+```
+
+### 注意事項
+
+- **前提条件**: プロジェクトルートでの実行が必要
+- **制限事項**: 大規模プロジェクトでは分析に時間がかかる場合があります
+- **推奨事項**: 循環依存が発見された場合は即座に対処を検討してください
+
+### ベストプラクティス
+
+1. **定期的な分析**: 週次で依存関係の健全性をチェック
+2. **ルールの明文化**: アーキテクチャルールを設定ファイルで管理
+3. **段階的改善**: 大規模なリファクタリングは避け、漸進的に改善
+4. **メトリクス追跡**: 依存関係の複雑度を時系列で監視