# codebase-map

Скилл codebase-map для Claude Code разбирает незнакомый репозиторий и собирает карту его архитектуры. Запускается по просьбе объяснить устройство проекта или проследить путь запроса.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 541 у репозитория
- Автор: dotslashsimran
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/dotslashsimran/simcraft/tree/HEAD/skills/coding/codebase-map/SKILL.md
- Обновлён: 2026-11-09
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/codebase-map

## Что делает

Скилл читает README, манифесты, CI, модели данных и историю Git, строит граф импортов и прослеживает один реальный запрос или команду во время запуска. Результат — `MAP.md` с диаграммой Mermaid, переходами по файлам и строкам, горячими точками, связями между файлами, глоссарием и первыми задачами; скрипт может создать и SVG.

Работа с репозиторием ведётся только на чтение, а промежуточные файлы складываются во временную папку, если не запрошен `MAP.md` в проекте. Скрипты используют стандартную библиотеку Python 3.9+ и Git. Для установки через Claude Code нужна команда `npx`; шаги анализа могут запускать код проекта, но миграции и действия с общей базой данных или реальными учётными данными запрещены.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dotslashsimran/simcraft --skill codebase-map -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/codebase-map/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/codebase-map/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dotslashsimran/simcraft --skill codebase-map -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/codebase-map/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dotslashsimran/simcraft --skill codebase-map -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/codebase-map/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dotslashsimran/simcraft skills/coding/codebase-map
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/codebase-map/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dotslashsimran/simcraft --skill codebase-map -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/dotslashsimran/simcraft --path skills/coding/codebase-map
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/codebase-map/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/dotslashsimran/simcraft/tree/HEAD/skills/coding/codebase-map/SKILL.md

## Когда брать
- разобраться, что делает незнакомый репозиторий
- найти файлы на пути пользовательского запроса
- выявить циклы импортов и горячие точки
- подготовить карту архитектуры для нового участника команды

## Примеры запросов агенту
- Объясни устройство этого репозитория и создай `MAP.md`.
- Проследи, где обрабатывается запрос на вход пользователя.
- Покажи горячие точки и связи между файлами в этом проекте.

## Похожие
- [acquire-codebase-knowledge](https://affpapa.org/nevibecode/skills/acquire-codebase-knowledge.md) — скилл · 2200 установок
- [gsd-map-codebase](https://affpapa.org/nevibecode/skills/gsd-map-codebase.md) — скилл · 589 установок
- [agent-3-codebase-explorer](https://affpapa.org/nevibecode/agents/agent-3-codebase-explorer.md) — субагент · ★ 138 у репозитория
- [codebase-summarizer](https://affpapa.org/nevibecode/skills/codebase-summarizer.md) — скилл · 411 установок
- [codebase-explorer](https://affpapa.org/nevibecode/agents/codebase-explorer.md) — субагент · 256 установок
- [codebase-recon](https://affpapa.org/nevibecode/plugins/codebase-recon.md) — плагин · ★ 1596 у репозитория

Из того же набора: [dotslashsimran/simcraft](https://affpapa.org/nevibecode/by/dotslashsimran/simcraft.md) — 24 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
