pimenov.ai

Правило для агента должно лежать там, где агент его читает

Кодинг-агент может технически решить неверно поставленную задачу. Как закрепить проверку постановки в памятке агента и применять её в Plan mode.

CodexИИ-агентыПрактика

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

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

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

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

Практическое правило для AGENTS.md может быть коротким:

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

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

Главное здесь — воспроизводимость. AGENTS.md задаёт правило по умолчанию, а Plan mode даёт отдельную фазу для его применения до начала реализации.

Следующий шаг

Если хотите разобраться, как встроить такую проверку в рабочий контур: Сначала архитектура, потом код: зачем ИИ-агенту контрольные барьеры

Связанные материалы

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

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov