codebase-orchestrator · voltagent/awesome-codex-subagents — субагент для Codex
Субагент codebase-orchestrator для управления масштабным рефакторингом в Codex через превью диффов и обязательное подтверждение правок человеком.
MIT ★ 6 505 обновлён 2026-10-05
.codex/agents/codebase-orchestrator.tomlЧто делает codebase-orchestrator
Субагент запрещает модели вносить правки в репозиторий без прямого одобрения пользователя. Работа идёт строго по шагам: анализ кодовой базы, подготовка предложений с превью изменений до и после, остановка до получения команды и только затем применение правок.
Приоритизация рисков зафиксирована: сначала проблемы безопасности, затем ломающие баги, архитектурные недочёты, производительность и лишь в конце стиль кода. При анализе субагент учитывает зависимости между модулями, исключает сгенерированные файлы и держит минимальный радиус изменений для каждого шага.
Без явного одобрения человека субагент не выполнит ни одной правки в коде. Если репозиторий слишком большой или доступ к файлам ограничен, он переключается на саммаризацию и сэмплирование вместо импровизации.
Какие задачи решает
- спланировать масштабный рефакторинг репозитория
- предотвратить неконтролируемые массовые правки кода
- ранжировать технический долг по уровню риска
- проверить превью диффов до применения изменений
Примеры запросов агенту
- Проанализируй кодовую базу и предложи план рефакторинга модуля auth
- Найди архитектурные проблемы в проекте и покажи диффы для безопасных правок
- Оцени риски обновления зависимостей и подготовь список точечных изменений
Как установить codebase-orchestrator
Вручную: положить файлы
.codex/agents/codebase-orchestrator.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.claude/agents/codebase-orchestrator.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.cursor/agents/codebase-orchestrator.mdCursor понимает и .claude/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 от других авторов.