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

architect-reviewer · voltagent/awesome-codex-subagents — субагент для Codex: архитектурная рецензия кода

Субагент architect-reviewer для проверки архитектурных решений: связанность модулей, границы систем, риски отказа, возможность развития. Анализирует дизайн и предлагает минимальные вмешательства, снижающие риск.

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

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

Что делает architect-reviewer

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

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

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

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

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

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

  • Проверь архитектуру хука перед интеграцией в продакшене
  • Оцени связанность нового микросервиса с остальной системой
  • Есть ли риски отказа в этом дизайне обработки ошибок?

Как установить architect-reviewer

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

.codex/agents/architect-reviewer.toml

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

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

Вопросы об architect-reviewer

Как установить architect-reviewer в Codex?

Создай файл .codex/agents/architect-reviewer.toml в корне проекта. Это описание субагента; Codex подхватит его автоматически.

Что делает architect-reviewer?

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

Работает ли architect-reviewer с другими платформами?

Основной инструмент — Codex. Файлы конфигурации есть также для Claude Code (.claude/agents/architect-reviewer.md) и Cursor (.cursor/agents/architect-reviewer.md), но возможности могут различаться.

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

architect-reviewer.toml · MIT
# architect-reviewer

Use when a task needs architectural review for coupling, system boundaries, long-term maintainability, or design coherence.

Own architecture review work as evidence-driven quality and risk reduction, not checklist theater.

Prioritize the smallest actionable findings or fixes that reduce user-visible failure risk, improve confidence, and preserve delivery speed.

Working mode:
1. Map the changed or affected behavior boundary and likely failure surface.
2. Separate confirmed evidence from hypotheses before recommending action.
3. Implement or recommend the minimal intervention with highest risk reduction.
4. Validate one normal path, one failure path, and one integration edge where possible.

Focus on:
- system boundary clarity and dependency direction between modules/services
- cohesion and coupling tradeoffs that affect long-term change velocity
- data ownership, consistency boundaries, and contract stability
- failure isolation and degradation behavior across critical interactions
- operability implications: observability, rollout safety, and incident recovery
- migration feasibility from current state to proposed target design
- complexity budget: avoiding over-engineering for local problems

Quality checks:
- verify findings map to concrete code/design evidence rather than style preference
- confirm each recommendation includes expected gain and tradeoff cost
- check for backward-compatibility and rollout-path implications
- ensure critical-path risks are prioritized over low-impact design debt
- call out assumptions that need runtime or product-context validation

Return:
- exact scope analyzed (feature path, component, service, or diff area)
- key finding(s) or defect/risk hypothesis with supporting evidence
- smallest recommended fix/mitigation and expected risk reduction
- what was validated and what still needs runtime/environment verification
- residual risk, priority, and concrete follow-up actions

Do not push a full architectural rewrite for scoped defects unless explicitly requested by the parent agent.

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

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

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

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

architect-reviewer VoltAgent Community Субагент architect-reviewer оценивает архитектуру системы, выбор стека и границы сервисов на макроуровне. Пригодится перед масштабным рефакторингом или при проектировании новой функциональности. CX Codex 743установок architect-reviewer qdhenry Субагент architect-reviewer проверяет изменения в коде на архитектурную согласованность: паттерны, SOLID, зависимости. Пригодится после структурных правок и появления новых сервисов. CX Codex ★ 1 357звёзд репо code-reviewer VoltAgent Community Субагент code-reviewer проверяет изменения в коде на ошибки, уязвимости и проблемы поддержки. Ставьте перед слиянием сложных изменений или аудитом проекта. CX Codex 31 050установок surgeon-reviewer VoltAgent Community Субагент surgeon-reviewer проводит жёсткое ревью кода: ищет критические баги, утечки и архитектурные мины без замечаний к стилю, выдавая чёткий вердикт о релизе. CX Codex ★ 26 718звёзд репо senior-architect sickn33 Скилл senior-architect для проектирования и проверки архитектуры системы на основе явных требований, компромиссов и фактических данных. Помогает выбрать решение, оценив текущее состояние, альтернативы и риски. CX Codex +1 2 200установок solution-architect zebbern Субагент solution-architect для Claude Code, Codex и Cursor сравнивает архитектурные варианты и рекомендует один с учётом ограничений. Включается, когда требования понятны, но решений несколько. CX Codex ★ 4 719звёзд репо plan-reviewer diet103 Субагент plan-reviewer анализирует планы доработки архитектуры, миграций баз данных и интеграций до написания кода. Помогает найти скрытые риски и пропущенные шаги. CX Codex ★ 10 055звёзд репо arch-reviewer SethGammon Субагент arch-reviewer проверяет архитектурные границы слоёв, циклические импорты и правила проекта без изменения файлов. CX Codex ★ 937звёзд репо

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

Весь набор →
compliance-auditor Субагент compliance-auditor проверяет контролы, аудитопригодность и пробелы в доказательствах. Подходит для регулируемых рабочих процессов. CX Codex ★ 6 505звёзд репо code-reviewer Субагент code-reviewer для комплексной проверки кода: анализирует поддерживаемость, дизайн и риски, а не только синтаксис. Выявляет проблемы в логике обработки ошибок, контрактах данных и побочных эффектах. CX Codex ★ 6 505звёзд репо chaos-engineer Субагент chaos-engineer анализирует устойчивость кода к сбоям зависимостей, планирует контролируемое внедрение отказов и находит слабые места в таймаутах или логике деградации сервиса. CX Codex ★ 6 505звёзд репо browser-debugger Субагент browser-debugger воспроизводит ошибки в браузере, собирает UI- и сетевые свидетельства и помогает найти причину клиентского сбоя. CX Codex ★ 6 505звёзд репо anti-ui-slop-reviewer Субагент anti-ui-slop-reviewer проводит контрольное ревью веб- и iOS-интерфейсов перед релизом. Находит шаблонный AI-дизайн, потерянные состояния компонентов и сбои в адаптивной вёрстке. CX Codex ★ 6 505звёзд репо ai-writing-auditor Субагент ai-writing-auditor для Codex проверяет текст на признаки ИИ-письма, переписывает найденные места и объясняет каждую правку. Проверяет посты, документацию и письма. CX Codex ★ 6 505звёзд репо ad-security-reviewer Субагент ad-security-reviewer разбирает безопасность Active Directory: границы доверия, делегирование, групповые политики, Kerberos и LDAP. Пригодится перед ужесточением каталога. CX Codex ★ 6 505звёзд репо accessibility-tester Субагент accessibility-tester проверяет доступность интерфейса, навигацию с клавиатуры и разметку ARIA. Пригодится при аудите компонентов и пользовательских сценариев перед релизом. CX Codex ★ 6 505звёзд репо

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

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