К основному содержанию
субагент CX Codex

codebase-mapper — субагент для Claude Code

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

MIT ★ 4 719 обновлён 2026-10-30

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/codebase-mapper.md
Открыть на GitHub

Что делает codebase-mapper

Субагент собирает карту кодовой базы перед принятием архитектурных решений или рефакторингом. Находит точки входа, границы владения кодом, вызывающие компоненты и потребителей данных. Выстраивает цепочки выполнения и выявляет границы будущих правок без случайных изменений в репозитории.

Работает в режиме планирования с моделью opus через инструменты Read, Grep, Glob и Bash. Субагент строго изолирован от записи: ему запрещено редактировать файлы, выполнять коммиты или запускать мутирующие команды. Результат возвращает со ссылками на строки вида path:line и статусами complete, blocked или inconclusive.

Для внешнего поиска или генерации кода субагент не предназначен: любые изменения исходников он блокирует намеренно.

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

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

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

  • Используй codebase-mapper, чтобы найти все точки входа для обработки вебхуков
  • Запусти субагента codebase-mapper и покажи поток данных при авторизации пользователя
  • Исследуй через codebase-mapper, какие модули пострадают при изменении схемы сессии

Как установить codebase-mapper

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

.claude/agents/codebase-mapper.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

Вопросы о codebase-mapper

Как установить codebase-mapper в Claude Code?

Сохраните конфигурацию субагента по пути .claude/agents/codebase-mapper.md.

Что делает codebase-mapper?

Анализирует внутреннюю структуру репозитория, трассирует вызовы и формирует точную карту зависимостей без редактирования файлов.

Может ли codebase-mapper изменять код в репозитории?

Нет. Субагенту явно запрещено редактировать файлы, создавать коммиты и запускать любые мутирующие команды.

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

codebase-mapper.md · MIT
---
name: codebase-mapper
description: "Use proactively when a task needs local repository structure, entry points, ownership, data flow, or change-surface mapping before a decision. Do not use for external documentation research, implementation, or post-change review."
tools:
  - Read
  - Grep
  - Glob
  - Bash
  - PowerShell
  - LSP
model: opus
permissionMode: plan
effort: max
---

# Mission

Map the local codebase evidence needed for the assigned question. Own repository tracing; leave external research, design selection, implementation, and review to the parent or their dedicated roles.

## Method

1. Read active repository instructions and inspect Git state without changing it.
2. Locate relevant entry points, configuration, ownership boundaries, callers, and consumers.
3. Trace control flow, data flow, state, and side effects only as far as the question requires.
4. Search for sibling occurrences of the same pattern and distinguish observed facts from inferences.
5. Return a bounded change surface and the evidence another role needs next.

## Constraints

- Do not edit, generate, install, commit, or run commands that intentionally mutate source or durable state.
- Do not research external documentation unless the task is blocked on identifying a product or version.
- Preserve user changes and report ambiguous ownership or scope instead of guessing.
- Treat tests as code evidence, not proof of real runtime behavior.

## Output

Begin with:

ROLE: codebase-mapper
STATUS: complete|blocked|inconclusive

Then provide: summary, evidence map with `path:line` citations, execution/data-flow map, likely change surface, sibling occurrences, unknowns, and the next decision required. Return distilled evidence rather than raw search logs.

## Stop conditions

Return `blocked` when the target, repository access, or success criterion is missing and different assumptions would materially change the map. Return `inconclusive` when the relevant path cannot be established from available source evidence.

© zebbern · MIT · zebbern/claude-code-guide

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
untangle-codebase caldoai Скилл untangle-codebase для Claude Code и других платформ, который автоматизирует глубокий рефакторинг всего проекта. Ищет скрытые связи, лишние зависимости и специальные случаи для упрощения кода. CX Codex +1 3 500установок codebase-architecture mblode Скилл codebase-architecture проектирует структуру TypeScript-кода, укрупняет мелкие модули и ставит проверки, которые держат репозиторий в форме. CX Codex +1 593установок codebase-analysis solatis Скилл codebase-analysis для быстрого знакомства с незнакомым репозиторием: запускает Python-скрипт, который сам обходит проект и собирает картину структуры, потоков и решений. CX Codex +1 587установок domain-model-boundaries-mapper patricio0312rev Скилл domain-model-boundaries-mapper анализирует архитектуру проекта по принципам Domain-Driven Design: находит доменные модули, границы ответственности и зависимости. Помогает спланировать разделение связанных компонентов. CX Codex +1 270установок gsd-codebase-mapper davepoon Субагент gsd-codebase-mapper исследует кодовую базу по заданному направлению (технологический стек, архитектура, качество кода, технический долг) и пишет структурированные документы анализа прямо в проект. CX Codex ★ 3 785звёзд репо explore-codebase tirth8205 Скилл explore-codebase для Claude Code помогает изучить структуру проекта через граф знаний. Запрашивайте архитектуру, ищите функции и прослеживайте связи между символами. CX Codex +1 1 200установок

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

Весь набор →
root-cause-debugger Субагент root-cause-debugger воспроизводит сбои и находит первопричину багов без правок в коде. Помогает локализовать поломку до начала написания фикса. CX Codex ★ 4 719звёзд репо code-reviewer Субагент code-reviewer для Claude Code проверяет готовые изменения на ошибки и регрессии. Запускается после реализации или при проверке существующего diff. CX Codex ★ 4 719звёзд репо perf-visibility-toggle Правило perf-visibility-toggle учит ассистента скрывать Three.js-компоненты через свойство visible, а не удалять их из дерева React, чтобы видеокарта не пересобирала шейдеры. CX Codex +1 ★ 4 719звёзд репо perf-r3f-perf Правило perf-r3f-perf добавляет в Claude Code знания о r3f-perf — библиотеке для отслеживания производительности Three.js сцен в реальном времени. Помогает находить узкие места: низкий FPS, утечки памяти, лишние пересчёты матриц. CX Codex +1 ★ 4 719звёзд репо solution-architect Субагент solution-architect для Claude Code, Codex и Cursor сравнивает архитектурные варианты и рекомендует один с учётом ограничений. Включается, когда требования понятны, но решений несколько. CX Codex ★ 4 719звёзд репо security-reviewer Субагент security-reviewer проверяет код на уязвимости, отслеживая путь непроверенных параметров до опасных вызовов. Не вносит правок в проект. CX Codex ★ 4 719звёзд репо runtime-verifier Субагент runtime-verifier проверяет готовые изменения через интерфейсы CLI, сервисов или файловой системы, фиксируя побочные эффекты без правок кода. CX Codex ★ 4 719звёзд репо official-docs-researcher Субагент official-docs-researcher сверяет актуальные сведения с официальной документацией и релизами. Вызывайте его, когда решение зависит от версии, API или поддерживаемых моделей. CX Codex ★ 4 719звёзд репо

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

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