Codemap
要約: コードベースのアーキテクチャを分析し、構造化ドキュメントを自動生成。
📌 コマンド
| コマンド | 説明 |
|---|---|
/codemap generate | 全体マップ生成 |
/codemap analyze <path> | 特定パス分析 |
/codemap diff | 既存との差分表示 |
🔍 分析内容
REQ-CM-001: リポジトリ構造
-
ワークスペース検出
cat package.json | jq '.workspaces' -
エントリーポイント識別
src/index.ts,src/main.tsbin/配下package.jsonのmain,exports
-
フレームワーク検出
- Next.js:
next.config.js,app/ - Express:
app.ts,routes/
- Next.js:
REQ-CM-002: モジュール分析
| 分析項目 | 検索方法 |
|---|---|
| エクスポート | grep "^export" src/index.ts |
| インポート | grep "from '" src/*.ts |
| APIルート | ls pages/api/ or grep router. |
| DBモデル | grep "^model" prisma/schema.prisma |
📁 出力構造 (REQ-CM-003)
docs/CODEMAPS/
├── INDEX.md # 全体概要
├── packages.md # パッケージ一覧
├── backend.md # バックエンド構造
├── frontend.md # フロントエンド構造
├── database.md # DBスキーマ
└── integrations.md # 外部サービス
INDEX.md テンプレート
# Codemap: [Project Name]
**Generated:** [日時]
**Version:** [バージョン]
## Overview
[プロジェクト概要]
## Structure
[ディレクトリ構造]
## Packages
| Package | Description |
|---------|-------------|
| core | コア機能 |
| api | APIサーバー |
## Entry Points
- `bin/cli.js` - CLI
- `src/index.ts` - Library
📊 Diff Threshold (REQ-CM-004)
WHEN 既存マップ更新時
DO 差分率を計算し、30%超過時はユーザー承認
出力:
📊 Codemap Diff
━━━━━━━━━━━━━━
Diff: 35% ⚠️
New: 5 modules
Removed: 2 modules
Changed: 8 modules
━━━━━━━━━━━━━━
Update? (y/n)
レポート保存: .reports/codemap-diff.txt
トレーサビリティ
- REQ-CM-001: Repository Structure Analysis
- REQ-CM-002: Module Analysis
- REQ-CM-003: Codemap Generation
- REQ-CM-004: Codemap Diff Threshold