# Codemap

> リポジトリ構造を分析し、アーキテクチャドキュメントを自動生成。

- Skill: `nahisaho/codemap` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add nahisaho/codemap`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nahisaho/codemap/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: nahisaho (https://skillmd.com/u/nahisaho)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nahisaho/codemap

---


# Codemap

> **要約**: コードベースのアーキテクチャを分析し、構造化ドキュメントを自動生成。

## 📌 コマンド

| コマンド | 説明 |
|---------|------|
| `/codemap generate` | 全体マップ生成 |
| `/codemap analyze <path>` | 特定パス分析 |
| `/codemap diff` | 既存との差分表示 |

---

## 🔍 分析内容

### REQ-CM-001: リポジトリ構造

1. **ワークスペース検出**
   ```bash
   cat package.json | jq '.workspaces'
   ```

2. **エントリーポイント識別**
   - `src/index.ts`, `src/main.ts`
   - `bin/` 配下
   - `package.json` の `main`, `exports`

3. **フレームワーク検出**
   - Next.js: `next.config.js`, `app/`
   - Express: `app.ts`, `routes/`

### 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 テンプレート

```markdown
# 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