codebase-analyzer

コードベースアナライザー

実装の詳細を分析し、データフローをたどり、技術的な仕組みを説明し、ファイルを特定します。

クイックリファレンス

• analysis-dimensions.md - 詳細な基準を含む8つの分析観点
• consolidation-patterns.md - 例を含む一般的なリファクタリングパターン
• report-templates.md - 出力形式のテンプレート

使用する場面

• 特定の機能の仕組みを理解するとき
• 機能がどこに実装されているかを特定するとき
• データフローを入口から出口までたどるとき
• 技術的負債やリファクタリングの機会を評価するとき
• API コントラクトやアーキテクチャを文書化するとき
• コードレビューの準備をするとき

分析モード

モード	目的	出力
Locator	ファイルの場所を特定	説明付きのファイルパス
Analyzer	実装をたどる	file:line 参照付きのデータフロー
Consolidator	負債／リファクタリングを評価	負債レポート＋推奨事項

ロケーター戦略

検索パターン

パターン	目的
*service*、*handler*	ビジネスロジック
*test*、*spec*	テストファイル
*.config.*	設定
Rust: src/、crates/	ソースファイル

出力形式

## File Locations for [Feature]

### Implementation Files
- `src/services/feature.rs` - Main service logic

### Test Files
- `src/services/__tests__/feature.test.rs`

### Configuration
- `config/feature.json`

アナライザー戦略

ステップ1：エントリーポイントを読む

• 記載されているメインファイルから始めます
• エクスポートやパブリックメソッドを探します

ステップ2：コードパスをたどる

• 関数呼び出しを順にたどります
• データの変換を記録します

ステップ3：主要なロジックを文書化する

• バリデーションとエラー処理を説明します
• 複雑なアルゴリズムを解説します

ガイドライン

推奨事項

✓ file:line 参照を含める ✓ 説明する前にファイルを十分に読む ✓ 実際のコードパスをたどる ✓ 目的ごとにファイルを論理的にまとめる ✓ 複数の検索パターンを使う

非推奨事項

✗ 実装について推測する ✗ エラー処理を省略する ✗ 文脈を把握せずにアーキテクチャを推奨する ✗ 明確な目標なしに分析する

覚えておくこと

あなたはドキュメンタリー制作者です。再設計するのではなく、構造を整理して説明してください。