プロジェクトの依存関係を分析し健全性を評価

プロジェクトの依存関係を分析し、アーキテクチャの健全性を評価します。

使い方

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. メトリクス追跡: 依存関係の複雑度を時系列で監視