0023 — Профили и маршрутизация AI-агентов¶

Дата: 2026-08-23.
Статус: Принято пользователем; project-scoped профили созданы и доказательно проверены в DEV.
Ответственный: владелец проекта.

Контекст¶

Решения 0021–0022 ввели общую память, Skills и доказательную приёмку, но без фактических профилей роли могли смешиваться: исполнитель мог проверять себя, tester — исправлять код, а координатор — передавать результат без task card.

Решение¶

Создать project-scoped профили orchestrator, architect, frontend, backend, tester, reviewer в .codex/agents/.
Не закреплять модель и reasoning effort; использовать наследование текущей родительской конфигурации.
Ограничить project config тремя одновременно открытыми subagent-потоками.
Сделать orchestrator, architect и reviewer read-only; frontend/backend наследуют sandbox, tester наследует sandbox для запуска проверок, но в verification не редактирует результат.
Использовать последовательность task card → executor → tester → reviewer по риску → orchestrator handoff.
Параллелизовать прежде всего независимую read-heavy работу; write-heavy задачи по умолчанию выполнять последовательно.
Полные контракты ролей и маршрутизация определены в docs/AGENT_ROLES.md и docs/AGENT_WORKFLOW.md.

Последствия¶

Специализация становится воспроизводимой после clone.
Роль агента не заменяет task-specific scope и permission boundaries.
Стоимость subagents контролируется ограничением потоков и запретом ненужной делегации.
Критический результат не принимается без отдельного verifier/reviewer.
Первый dry-run прошёл реальную цепочку executor → tester → reviewer → orchestrator; итог принят только после исправления всех найденных несоответствий.

Откат или замена¶

Закрепление обязательных моделей, изменение числа потоков, разрешение параллельной write-heavy работы по умолчанию или объединение executor и единственного verifier для критических задач требует нового ADR.