analyze-codebase

コードベースを分析する

使用するタイミング

• 新しい開発者のオンボーディング
• アーキテクチャのドキュメント作成
• プロジェクトの健全性評価
• 大規模なリファクタリングの前
• システムの複雑さの把握

分析プロセス

ステップ 1：調査

# Project structure
tree -L 3 -I 'node_modules|.next|dist|build|coverage'

# File counts
find . -type f -name "*.ts" | wc -l
find . -type f -name "*.tsx" | wc -l

ステップ 2：アーキテクチャ分析

• モジュール、エントリーポイント、API 構造を特定します
• フロントエンドのコンポーネントとルーティングをマッピングします
• サービスのパターンと規約を記録します

ステップ 3：パターンと標準

• ドキュメントやサンプルで確立されたパターンを確認します
• 型システムの構成を分析します
• セキュリティパターン（認証、マルチテナンシー、論理削除）を確認します

ステップ 4：依存関係

• 外部サービスとライブラリを一覧にします
• バージョンが最新か確認します
• 重要な依存関係を特定します

ステップ 5：レポートの作成

.agents/memory/codebase-analysis.md に次のセクションを含めて記述します：

1. エグゼクティブサマリー — 3～5 文の概要
2. プロジェクト概要 — 技術スタック、目的、アーキテクチャスタイル
3. ディレクトリ構成 — モジュールの配置と構成
4. アーキテクチャパターン — バックエンドとフロントエンドのパターン
5. セキュリティ分析 — 認証、データ分離、検証
6. パフォーマンスに関する考察 — データベース、キャッシュ、バックグラウンドジョブ
7. コード品質 — 強み、改善点、技術的負債
8. 依存関係 — 重要なパッケージとバージョン一覧
9. テスト戦略 — カバレッジ、パターン、課題
10. 推奨事項 — 直ちに行うこと、短期的な対応、長期的な対応

クイックモード

より迅速に分析する場合（詳細な指標は省略）：

tree -L 3 -I 'node_modules|.next|dist'
echo "TypeScript: $(find . -name '*.ts' -o -name '*.tsx' | wc -l)"
echo "Controllers: $(find . -name '*.controller.ts' | wc -l)"
echo "Services: $(find . -name '*.service.ts' | wc -l)"