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

code-mapper — субагент для Codex: что делает и как установить

Субагент code-mapper для Codex и Claude Code строит карту путей кода, границ владения и потока выполнения перед изменениями. Разбирает сложное поведение проекта.

MIT ★ 6 505 обновлён 2026-10-05

Установить в Codex · Вручную: положить файлы Все способы и платформы ↓
.codex/agents/code-mapper.toml
Открыть на GitHub

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

code-mapper исследует проект до начала правок. Он находит точки входа и пользовательские или системные триггеры, затем прослеживает выполнение через сервисы, базу данных, внешние API, UI-адаптеры и асинхронные workers. На выходе получается основной путь, ветвления и места, где теряется уверенность в трассировке.

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

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

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

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

  • Используй субагент code-mapper и построй путь выполнения для авторизации.
  • Составь карту кода для ошибки при сохранении заказа: укажи файлы, символы и ветки.
  • Проверь, где проходят валидация, запись в базу данных и отправка задачи в очередь.

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

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

.codex/agents/code-mapper.toml

Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

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

Вопросы о code-mapper

Как установить code-mapper в Codex?

Добавьте файл .codex/agents/code-mapper.toml в проект, убрав лишний пробел внутри обратных кавычек.

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

Он исследует кодовую базу, находит точки входа, строит цепочку выполнения и отмечает ветвления, проверки и границы побочных эффектов.

Предлагает ли code-mapper исправления?

Нет. Субагент остаётся в режиме исследования и не предлагает правки или редизайн архитектуры без отдельного запроса.

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

code-mapper.toml · MIT
# code-mapper

Use when the parent agent needs a high-confidence map of code paths, ownership boundaries, and execution flow before changes are made.

Stay in exploration mode. Reduce uncertainty with concrete path mapping.

Working mode:
1. Identify entry points and user/system triggers.
2. Trace execution to boundary layers (service, DB, external API, UI adapter, async worker).
3. Distill primary path, branch points, and unknowns.

Focus on:
- exact owning files and symbols for target behavior
- call chain and state transition sequence
- policy/guard/validation checkpoints
- side-effect boundaries (persistence, external IO, async queue)
- branch conditions that materially change behavior
- shared abstractions that could amplify change impact

Mapping checks:
- distinguish definitive path from likely path
- separate core behavior from supporting utilities
- identify where tracing confidence drops and why
- avoid speculative fixes unless explicitly requested

Return:
- primary owning path (ordered steps)
- critical files/symbols by layer
- highest-risk branch points
- unresolved unknowns plus fastest next check to resolve each

Do not propose architecture redesign or code edits unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

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

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
gsd-codebase-mapper davepoon Субагент gsd-codebase-mapper исследует кодовую базу по заданному направлению (технологический стек, архитектура, качество кода, технический долг) и пишет структурированные документы анализа прямо в проект. CX Codex ★ 3 785звёзд репо gitnexus-debugging abhigyanpatwari Скилл gitnexus-debugging для Claude Code ищет причины ошибок в коде по связям между символами, вызовами и процессами. Трассирует сбои и регрессии. CX Codex +1 1 800установок domain-model-boundaries-mapper patricio0312rev Скилл domain-model-boundaries-mapper анализирует архитектуру проекта по принципам Domain-Driven Design: находит доменные модули, границы ответственности и зависимости. Помогает спланировать разделение связанных компонентов. CX Codex +1 270установок fullstack-developer VoltAgent Community Субагент fullstack-developer ведёт фичу через базу данных, API и frontend как единую задачу. Подходит для сквозной разработки с общей логикой и тестами. CX Codex 18 117установок socraticode giancarloerra Плагин socraticode для Claude Code строит индекс кодовой базы и отвечает на вопросы о связях между её частями. Он подключается к задачам поиска по проекту и анализа влияния изменений. ★ 3 380звёзд репо codebase-mapper zebbern Субагент codebase-mapper исследует структуру репозитория, потоки данных и точки входа перед внесением правок, не меняя рабочий код. CX Codex ★ 4 719звёзд репо

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

Весь набор →
graphql-architect Субагент graphql-architect анализирует GraphQL-схемы на ошибки архитектуры, риски производительности и безопасности. Помогает эволюционировать схему, проектировать резолверы и федерацию без регрессий. CX Codex ★ 6 505звёзд репо fullstack-developer Субагент fullstack-developer ведёт сквозную задачу через фронтенд и бэкенд, от действия пользователя в интерфейсе до сохранения данных. Помогает, когда всю цепочку должен закрыть один исполнитель. CX Codex ★ 6 505звёзд репо frontend-developer Субагент frontend-developer ведёт точечные изменения интерфейса и исправляет UI-баги с проверкой состояний, доступности и соседних регрессий. CX Codex ★ 6 505звёзд репо electron-pro Субагент electron-pro для работы с Electron-приложениями: помогает разбираться в границах между main, preload и renderer, настраивать IPC-мосты, проверять безопасность и готовить приложение к упаковке. CX Codex ★ 6 505звёзд репо design-bridge Субагент design-bridge разбирает файл DESIGN.md и превращает дизайн-систему бренда в готовые спецификации для фронтенд-агентов. CX Codex ★ 6 505звёзд репо backend-developer Субагент backend-developer для Codex реализует точечные изменения серверной логики и исправляет ошибки после определения нужного пути кода. Он проверяет поведение на успешном сценарии и при сбое. CX Codex ★ 6 505звёзд репо api-designer Субагент api-designer проектирует контракты API, планирует версионирование и проверяет совместимость изменений до написания кода в Codex. CX Codex ★ 6 505звёзд репо healthcare-admin Субагент healthcare-admin помогает с задачами администрирования здравоохранения: от медицинского кодирования до анализа договоров с плательщиками. Вызывайте его для работы с операционными и комплаенс-вопросами. CX Codex ★ 6 505звёзд репо

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

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