К основному содержанию
скилл CX Codex

map · sethgammon — скилл для Claude Code: что делает и как установить

Скилл map строит компактный JSON-индекс кодовой базы с файлами, экспортами, импортами и графом зависимостей, чтобы агент находил нужные файлы без лишних Glob и Grep.

MIT ★ 937 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-local
Открыть на GitHub

Что делает map

Скилл запускает node scripts/map-index.js --generate --root ., обходит дерево проекта с учётом .gitignore, пропускает node_modules и dist, затем вытаскивает из файлов экспорты, импорты и символы. Для каждого файла определяется роль — компонент, хук, стор, роут, тест или конфиг, — и на основе путей импорта строится граф зависимостей. Индекс попадает в .planning/map/index.json, а по SHA-256-хешам файлов команда /map stale понимает, что изменилось.

Поддерживаются TypeScript, JavaScript, Python, Go и Rust. Индекс кешируется на 5 минут, повторный запуск в этом окне просто завершается без пересборки, если не передан флаг --force.

Отдельная команда /map slice формирует компактный блок под конкретные ключевые слова и ограничивает вывод 8000 символами, чтобы его можно было безопасно вставить в контекст другого агента. При командной работе через Fleet такой срез автоматически добавляется в промпт каждого агента рядом с CLAUDE.md, если индекс уже существует.

Какие задачи решает

  • найти файлы по ключевому слову без чтения всего проекта
  • построить граф зависимостей между модулями
  • дать агентам Fleet контекстный срез по их зоне ответственности вместо полного обхода
  • проверить, не устарел ли индекс после правок
  • получить сводку по языкам, ролям файлов и количеству роутов

Примеры запросов агенту

  • Запусти /map и построй индекс кодовой базы
  • Найди через /map query auth файлы, связанные с авторизацией
  • Проверь /map stale перед запуском кампании

Как установить map

1Через маркетплейс плагинов

/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-local

Команда ставит плагин citadel целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add SethGammon/Citadel --skill map -a claude-code

3Вручную: положить файлы

~/.claude/skills/map/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/map/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о map

Как установить map в Claude Code?

Выполните /plugin marketplace add SethGammon/Citadel, затем /plugin install citadel@citadel-local.

Что делает скилл map?

Он строит JSON-индекс проекта с файлами, экспортами, импортами, графом зависимостей и ролями файлов, по которому можно искать по ключевым словам. Индекс также используется для подготовки компактных контекстных срезов для других агентов.

Какие языки поддерживает map?

TypeScript, JavaScript, Python, Go и Rust.

Исходный текст

SKILL.md · MIT
---
name: map
license: MIT
description: >-
  Structural codebase index generator. Builds a compact JSON map of files,
  exports, imports, dependency graph, and roles. Queryable by keyword. Injected
  into fleet agents as context slices to reduce token usage on code navigation.
user-invocable: true
auto-trigger: false
trigger_keywords:
  - map
  - index codebase
  - codebase map
  - structural index
  - scan codebase
  - map stats
  - map query
last-updated: 2026-03-29
---

# /map -- Codebase Intelligence

## Orientation

Use `/map` when:
- Starting work on an unfamiliar codebase (build the index first)
- A fleet or archon campaign needs agents to know "what files matter for X"
- You want a quick structural overview (stats, roles, dependency graph)
- You need to find files related to a keyword without exploratory reads

Do not use `/map` for:
- Reading file contents (use Read)
- Searching for string patterns inside files (use Grep)
- Single-file edits where you already know the path

## Commands

| Command | Behavior |
|---|---|
| `/map` | Generate or refresh the index (skips if cache is fresh) |
| `/map --force` | Rebuild the index even if cache is fresh |
| `/map query <terms>` | Search the index for files matching keywords |
| `/map stats` | Print summary statistics (files, lines, languages, roles) |
| `/map slice <terms>` | Output a compact context slice for agent injection |
| `/map stale` | Detect added, changed, or removed indexed source files |

## Protocol

### Step 1: GENERATE INDEX

Run the index generator:

```bash
node scripts/map-index.js --generate --root .
```

Add `--force` if the user requested a fresh rebuild or if the index is stale.

The generator:
1. Walks the project tree (respects `.gitignore`, skips `node_modules`, `dist`, etc.)
2. Extracts exports, imports, and symbols from each source file
3. Infers a role for each file (component, hook, store, route, test, config, etc.)
4. Builds a dependency graph from resolved import paths
5. Records per-file SHA-256 hashes plus a whole-index source signature
6. Extracts route-like paths and package verification scripts
7. Writes the index to `.planning/map/index.json`

**Supported languages:** TypeScript, JavaScript, Python, Go, Rust.

**Cache behavior:** The index is cached for 5 minutes. Subsequent runs within
that window exit immediately unless `--force` is passed.

If `.planning/map/` does not exist, the generator creates it automatically.

### Step 2: QUERY (when user provides search terms)

```bash
node scripts/map-index.js --query "<terms>"
```

The query engine scores files by:
- Path match: +3 per term
- Export match: +5 per term
- Symbol match: +2 per term
- Role match: +1 per term

Results are sorted by score and capped at 20 files (configurable with `--max-files`).
Output is budget-capped at 8000 characters to stay injection-safe.

### Step 3: STATS (structural overview)

```bash
node scripts/map-index.js --stats
```

Outputs: file count, line count, export count, dependency edge count, route count,
package script count, verification command count, breakdown by language, and
breakdown by role.

### Step 4: SLICE (agent context injection)

When another skill or orchestrator needs a map slice for agent injection:

1. Run `node scripts/map-index.js --slice "<scope terms>" --max-files 15`
2. Inject the generated compact block:

```
=== MAP SLICE: <terms> ===
Generated: <timestamp>
Verification: npm run test | npm run typecheck
<score> <role>  <path>  [<top exports>]  (<lines>L)
...
=== END MAP SLICE ===
```

3. The calling skill injects this block into the agent's prompt alongside
   CLAUDE.md and rules-summary.md

**Token budget:** A 15-file slice is typically 800-1200 tokens. This replaces
2000-5000 tokens of exploratory Glob/Grep results that agents would otherwise
spend finding relevant files.

### Step 5: STALENESS CHECK

Before injecting an existing map into a long-running campaign, run:

```bash
node scripts/map-index.js --stale
```

The command exits `0` when the map is current and `2` when indexed source files
were added, changed, or removed. Refresh with:

```bash
node scripts/map-index.js --generate --force --root .
```

## Fleet Integration

Fleet agents receive map slices automatically when `/map` index exists:

1. Before spawning each wave, Fleet checks if `.planning/map/index.json` exists
2. If it exists: Fleet runs a slice scoped to each agent's assigned domain
3. The generated slice is prepended to the agent's context alongside CLAUDE.md
   and rules-summary.md
4. If the index does not exist: Fleet proceeds without a map slice (no error)

**Context injection order:**
1. CLAUDE.md content
2. `.claude/agent-context/rules-summary.md`
3. **Map slice** (scoped to agent's domain/direction)
4. Campaign-specific direction and scope
5. Discovery briefs from previous waves

## Contextual Gates

**Disclosure:** "Generating codebase map. Creates `.planning/map/index.json`."
**Reversibility:** green — creates `.planning/map/index.json` only; undo by deleting `.planning/map/`.
**Trust gates:**
- Any: generate index, query, stats, slice.

## Quality Gates

- Index must generate without errors on any supported project
- Query must return results sorted by relevance score
- Stats output must be human-scannable in under 5 seconds
- Slice output must stay under 2000 tokens for a 15-file result
- Index must handle 100K+ line repos without hanging (iterative walker, no recursion limits)
- Cache must prevent redundant regeneration within the TTL window
- Stale checks must detect added, changed, and removed indexed source files
- Slice output must include relevant verification commands when package scripts exist

## Fringe Cases

- **No source files found**: Generator writes an empty index (`fileCount: 0`). Query returns no results. Not an error.
- **`.planning/` does not exist**: Generator creates `.planning/map/` automatically via `mkdirSync({ recursive: true })`.
- **Index file missing when querying**: Error message: "Index not found. Run `node scripts/map-index.js --generate` first."
- **Binary or unsupported files**: Silently skipped. Only files with recognized language extensions are indexed.
- **Very large repos (10K+ files)**: The walker is iterative (stack-based), not recursive. No stack overflow risk. May take 5-10 seconds on first run.
- **Windows paths**: All stored paths use forward slashes for cross-platform consistency.

## Exit Protocol

After generation:
```
Index written: <path>
  <file count> files, <edge count> dependency links
  <route count> routes, <verification command count> verification commands
```

After query:
```
Results for "<terms>" (<count> matches):
  Score  Role        Path
  -----------------------------------------------
  <results>
```

After stats: print the full statistics block.

After slice: output the formatted slice block ready for injection.

After stale check:
```
Map index is current.
```

or:

```
Map index is stale.
Changed: <paths>
Added: <paths>
Removed: <paths>
```

Reversibility: green — delete `.planning/map/` to remove all generated artifacts; no source files modified.

© SethGammon · MIT · SethGammon/Citadel

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Сначала — map от других авторов.

map Yeachan-Heo Скилл map для Claude Code направляет задачу к подходящему скиллу из набора. Он сопоставляет запрос с этапом работы или отдельным сценарием, но сам задачу не выполняет. CX Codex +1 160установок modernize-map официальный Anthropic Команда modernize-map строит интерактивную карту зависимостей, потоков данных и точек входа устаревшей системы. Помогает изучить связи между модулями перед рефакторингом или модернизацией. CX Codex +1 ★ 47 914звёзд репо codependix-navigate organizzolini Скилл codependix-navigate учит агента отвечать на вопросы о зависимостях: как проект A доходит до C, что сломается при правке файла. Через codependix path или графы, уже лежащие в репозитории. CX Codex +1 364установок qe-code-intelligence proffesor-for-testing Скилл qe-code-intelligence строит семантический индекс кодовой базы, карты зависимостей и граф знаний. Помогает разобраться в незнакомом коде, отследить цепочки вызовов и найти нужные участки по смыслу запроса. CX Codex +1 122установок codependix-export organizzolini Скилл codependix-export для Claude Code запускает экспорт графов зависимостей codependix и проверку архитектурных границ. Выполняет режимы проверки отчётов, целостности связей и записи артефактов. CX Codex +1 364установок mcp-codebase-index MikeRecognex MCP-сервер mcp-codebase-index разбирает проект на функции, классы и зависимости и отдаёт агенту 18 инструментов запросов вместо чтения файлов целиком. CX Codex +1 ★ 63звёзд репо Codeix montanetech MCP-сервер Codeix для Claude Code и ещё семи платформ: индексирует символы, ссылки и вызовы по всей кодовой базе. Агент получает готовую карту проекта вместо серии grep-запросов. CX Codex +1 ★ 9звёзд репо

Из того же набора55

Весь набор →
prd Собирает PRD по описанию приложения: задаёт вопросы, определяет объём и технические решения. Документ можно передать Archon для разбиения на кампанию. CX Codex +1 ★ 937звёзд репо organize Скилл organize для аудита и исправления структуры проекта: проверяет, где лежат файлы, переносит их по конвенции и обновляет импорты. Код внутри файлов не трогает. CX Codex +1 ★ 937звёзд репо create-app Скилл create-app для Claude Code и Codex автоматизирует создание приложений по текстовому описанию. Он делит задачу на пять уровней и ведёт разработку через PRD, архитектуру и верификацию. CX Codex +1 ★ 937звёзд репо postmortem Скилл postmortem разбирает завершённую кампанию или инцидент по файлам проекта, телеметрии и истории Git. Помогает выяснить, что сломалось и что поймали защитные проверки. CX Codex +1 ★ 937звёзд репо phase-validator Субагент phase-validator сверяет отчёт о завершении этапа с условиями выхода и выносит вердикт pass или fail. Помогает контролировать автоматические конвейеры разработки. CX Codex ★ 937звёзд репо fleet Субагент fleet для Claude Code делит работу на кампании и ведёт их волнами по 2–3 агента, передавая находки следующей волне. Разбивает задачи, не пересекающиеся по файлам. CX Codex ★ 937звёзд репо workspace Скилл workspace координирует изменения в нескольких репозиториях в рамках одной задачи. Разбивает работу на волны, запускает кампании по репозиториям, проверяет контракты между ними. CX Codex +1 ★ 937звёзд репо create-skill Скилл create-skill интервьюирует разработчика и упаковывает повторяющийся сценарий в готовый SKILL.md с проверкой на реальном коде проекта. CX Codex +1 ★ 937звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой