# Codemap

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

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

---


# 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

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/nahisaho) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->