wasabeef プロジェクトの依存関係を分析し健全性を評価
プロジェクトの依存関係を分析し、アーキテクチャの健全性を評価します。
使い方
/dependency-analysis [オプション]
オプション
--visual: 依存関係を視覚的に表示--circular: 循環依存のみを検出--depth <数値>: 分析の深さを指定 (デフォルト: 3)--focus <パス>: 特定のモジュール/ディレクトリに焦点
基本例
# プロジェクト全体の依存関係分析
/dependency-analysis
# 循環依存の検出
/dependency-analysis --circular
# 特定モジュールの詳細分析
/dependency-analysis --focus src/core --depth 5
分析項目
1. 依存関係マトリックス
モジュール間の依存関係を数値化して表示：
- 直接依存
- 間接依存
- 依存の深さ
- ファンイン/ファンアウト
2. アーキテクチャ違反検出
- レイヤー違反 (下位層が上位層に依存)
- 循環依存
- 過度な結合 (高い依存度)
- 孤立したモジュール
3. Clean Architecture 準拠チェック
- ドメイン層の独立性
- インフラ層の適切な分離
- ユースケース層の依存方向
- インターフェースの適用状況
出力例
依存関係分析レポート
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 メトリクス概要
├─ 総モジュール数: 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 アートで表示]
高度な使用例
# CI/CD パイプラインでの自動チェック
/dependency-analysis --circular --fail-on-violation
# アーキテクチャルールの定義と検証
/dependency-analysis --rules .architecture-rules.yml
# 時系列での依存関係の変化を追跡
/dependency-analysis --compare HEAD~10
設定ファイル例 (.dependency-analysis.yml)
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 との連携
# package.json を含めた分析
cat package.json
/analyze-dependencies
「このプロジェクトの依存関係の問題点を分析して」
# 特定モジュールのソースコードと組み合わせ
ls -la src/core/
/analyze-dependencies --focus src/core
「コアモジュールの依存関係を詳細に評価して」
# アーキテクチャドキュメントとの比較
cat docs/architecture.md
/analyze-dependencies --visual
「設計ドキュメントと実装の乖離を確認して」
注意事項
- 前提条件: プロジェクトルートでの実行が必要
- 制限事項: 大規模プロジェクトでは分析に時間がかかる場合があります
- 推奨事項: 循環依存が発見された場合は即座に対処を検討してください
ベストプラクティス
- 定期的な分析: 週次で依存関係の健全性をチェック
- ルールの明文化: アーキテクチャルールを設定ファイルで管理
- 段階的改善: 大規模なリファクタリングは避け、漸進的に改善
- メトリクス追跡: 依存関係の複雑度を時系列で監視