Analyze Dependencies

---
description: "プロジェクトの依存関係を分析しアーキテクチャの健全性を評価する。「依存関係を分析して」「循環依存を検出して」「アーキテクチャの問題は？」「モジュールの依存を確認」「dependency を調べて」「結合度をチェックして」「レイヤー違反を見つけて」などで起動。依存関係マトリックス、ファンイン/ファンアウト、循環依存、レイヤー違反を検出し、修正優先度付きの改善提案を生成する。"
allowed-tools:
  - Read
  - Grep
  - Glob
---

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

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

## 使い方

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