# gsd-codebase-mapper

Субагент gsd-codebase-mapper исследует кодовую базу по заданному направлению (технологический стек, архитектура, качество кода, технический долг) и пишет структурированные документы анализа прямо в проект.

- субагент · `type=agent` · Claude Code, Cursor, Codex · ★ 3785 у репозитория
- Автор: davepoon
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/gsd/agents/gsd-codebase-mapper.md
- Обновлён: 2026-10-25
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/gsd-codebase-mapper

## Что делает

gsd-codebase-mapper — часть экосистемы GSD. Его вызывает команда `/gsd:map-codebase` с одним из четырёх фокусов: tech (стек и интеграции), arch (структура и архитектура), quality (соглашения и тесты) или concerns (проблемы и долг). Субагент читает файлы проекта, проверяет скилы из `.claude/skills/`, `.agents/skills/` или `.cursor/skills/`, и пишет документы в `.planning/codebase/` — STACK.md, INTEGRATIONS.md, ARCHITECTURE.md, STRUCTURE.md, CONVENTIONS.md, TESTING.md или CONCERNS.md в зависимости от фокуса.

Документы потом загружают `/gsd:plan-phase` (для планирования фаз разработки) и `/gsd:execute-phase` (для написания кода по шаблонам проекта). Субагент работает с tools Read, Bash, Grep, Glob и Write — не требует доступ к интернету. Если в промпте указана строка `--paths`, субагент ограничивает сканирование этими путями (для переанализа после изменений).

## Установка

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

**Вручную: положить файлы**
- Файл: `.claude/agents/gsd-codebase-mapper.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/gsd-codebase-mapper.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/gsd/agents/gsd-codebase-mapper.md

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

## Примеры запросов агенту
- /gsd:map-codebase tech
- /gsd:map-codebase `arch --paths src/services,src/utils`
- /gsd:map-codebase quality

## Похожие
- [gsd-map-codebase](https://affpapa.org/nevibecode/skills/gsd-map-codebase.md) — скилл · 589 установок
- [gsd-onboard](https://affpapa.org/nevibecode/skills/gsd-onboard.md) — скилл · 550 установок
- [codebase-mapper](https://affpapa.org/nevibecode/agents/codebase-mapper.md) — субагент · ★ 4719 у репозитория
- [code-mapper](https://affpapa.org/nevibecode/agents/code-mapper.md) — субагент · ★ 6505 у репозитория
- [explore-codebase](https://affpapa.org/nevibecode/skills/explore-codebase.md) — скилл · 1200 установок
- [codebase-documenter](https://affpapa.org/nevibecode/skills/mhattingpete-codebase-documenter.md) — скилл · 595 установок

Из того же набора: [davepoon/buildwithclaude](https://affpapa.org/nevibecode/by/davepoon/buildwithclaude.md) — 235 карточек

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

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