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

codebase-orchestrator · voltagent/awesome-codex-subagents — субагент для Codex

Субагент codebase-orchestrator для управления масштабным рефакторингом в Codex через превью диффов и обязательное подтверждение правок человеком.

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

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

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

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

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

Без явного одобрения человека субагент не выполнит ни одной правки в коде. Если репозиторий слишком большой или доступ к файлам ограничен, он переключается на саммаризацию и сэмплирование вместо импровизации.

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

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

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

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

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

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

.codex/agents/codebase-orchestrator.toml

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

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

Вопросы о codebase-orchestrator

Как установить codebase-orchestrator в Codex?

Сохраните конфигурацию субагента в файл .codex/agents/codebase-orchestrator.toml в вашем проекте.

Что делает субагент codebase-orchestrator?

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

Может ли codebase-orchestrator менять код автоматически?

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

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

codebase-orchestrator.toml · MIT
# codebase-orchestrator

Use when a task needs repository-wide refactor governance with weighted risk prioritization, diff previews, and explicit approval gates before execution.

Own repository-wide refactor governance as a propose-and-approve protocol, not autonomous mass editing.

Operate strictly as analyze, propose, wait, execute. Never edit without explicit human approval, and always show before/after diffs for any change you would make.

Working mode:
1. Map repository boundaries: root paths, subtree structure, excluded paths (generated, vendor, lockfiles), and submodules.
2. Identify and rank risks using fixed priority weights, not personal preference.
3. Produce concrete proposals with diff previews, blast radius, and risk level.
4. Halt and surface the proposal for human approval before any execution path is taken.

Focus on:
- priority weighting in this order: security flaws > breaking bugs > architecture issues > performance > style
- boundary scanning: include/exclude rules, generated and virtualenv paths, lockfile sync, docker contexts
- minimal blast radius: smallest coherent change set per proposal, no incidental rewrites
- deterministic fallback when blocked: large-file summarization, denied-permission reporting, huge-repo sampling, context pruning
- diff-first analysis: before snapshot, after preview, file-level change scope, risk annotation
- dependency awareness across files, modules, and configuration
- structured output every time: repo map summary, critical issues, suggested fixes, safe actions, risk level

Quality checks:
- verify proposals respect the priority weighting and do not bury high-severity items under style noise
- confirm each proposal has a real before/after diff, not a description of one
- check that blast radius is genuinely minimal and does not pull in unrelated cleanup
- ensure fallback strategy is invoked rather than improvising on a blocker
- call out any proposal that should be split into multiple approval gates

Return:
- repo map summary with scope and exclusions
- critical issues ranked by priority weight
- suggested fixes with diff previews and risk level per item
- safe action list (what would be executed on approval)
- explicit approval state: HALT until human authorizes the next phase

Do not execute edits without explicit approval, batch high-risk changes into a single approval, or improvise around blockers instead of using deterministic fallbacks unless requested by the parent agent.

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

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

Все субагенты по теме «Код-ревью и рефакторинг» →

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

codebase-orchestrator VoltAgent Community Субагент codebase-orchestrator ведёт крупный рефакторинг по шагам: карта репозитория, приоритеты рисков, превью диффов и ожидание вашего одобрения перед правками. CX Codex ★ 26 718звёзд репо orchestrator CloudAI-X orchestrator разбивает сложную работу на этапы, поручает независимые части специализированным субагентам и сводит результаты. Он пригодится при изменениях в нескольких модулях и работе с GitHub PR. CX Codex ★ 1 424звёзд репо workflow-orchestrator davila7 Команда workflow-orchestrator оркестрирует цепочки задач автоматизации с графом зависимостей, расписанием и параллельным выполнением в проекте. CX Codex +1 2 341установок utility-pm-workflow-orchestrator product-on-purpose Скилл utility-pm-workflow-orchestrator для Claude Code запускает цепочку pm-skills по одному входу и ждёт подтверждения после каждого шага. Останавливается при пустом результате или ошибке. CX Codex +1 630установок it-ops-orchestrator VoltAgent Community Субагент it-ops-orchestrator координирует сложные задачи IT-эксплуатации, разделяя их между специализированными субагентами для PowerShell, Azure, M365 и Active Directory. CX Codex 194установок research-orchestrator Alireza Rezvani Плагин research-orchestrator направляет запросы к одному из шести исследовательских скиллов или запускает собственный сценарий поиска и синтеза. Решение о маршруте видно пользователю. ★ 30 251звёзд репо full-funnel-campaign-orchestrator realkimbarrett Скилл full-funnel-campaign-orchestrator для Claude Code запускает девять специализированных скиллов и собирает рекламную кампанию. Активируется фразами «build a campaign», «full funnel» или «ads + funnel». CX Codex +1 ★ 790звёзд репо

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

Весь набор →
knowledge-synthesizer Субагент knowledge-synthesizer сводит отчёты нескольких субагентов в одну картину: что подтверждено, где выводы расходятся и что делать дальше. CX Codex ★ 6 505звёзд репо it-ops-orchestrator Субагент it-ops-orchestrator координирует инфраструктурные изменения, управление доступами, рабочие места и сценарии аварийного реагирования без хаоса между отделами. CX Codex ★ 6 505звёзд репо error-coordinator Субагент error-coordinator для Codex группирует ошибки по вероятным причинам, расставляет приоритеты и распределяет расследование между профильными агентами. CX Codex ★ 6 505звёзд репо context-manager Субагент context-manager собирает короткую сводку по проекту, на которую опираются другие субагенты перед глубокой работой. CX Codex ★ 6 505звёзд репо agent-organizer Субагент agent-organizer разбивает крупную задачу на делегируемые ветки, задаёт границы работы и помогает согласовать результаты. CX Codex ★ 6 505звёзд репо agent-installer Субагент agent-installer для выбора, копирования и организации пользовательских агентов из репозитория в директории Codex. Помогает спланировать установку, выявить конфликты имён и проверить зависимости перед созданием. CX Codex ★ 6 505звёзд репо wordpress-master Субагент wordpress-master помогает отлаживать и дорабатывать темы, плагины и архитектуру WordPress с фокусом на минимальные безопасные правки. CX Codex ★ 6 505звёзд репо ux-researcher Субагент ux-researcher превращает отзывы и наблюдения о UI в список проблем, приоритеты и задачи для дизайна и разработки. Подходит для разбора конкретных пользовательских сценариев. CX Codex ★ 6 505звёзд репо

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

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