ИИ-агент без правил прошёл 6 проверок из 8: остальное закрепляет файл AGENTS.md

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

Возьмём вайб-кодинг, то есть проект, который за вас пишет в основном агент по словесным просьбам. Вы договорились, что SQL (язык запросов к базе данных) лежит только в файле db.py, а отмена подписки пишется в журнал аудита, где фиксируется, кто и что изменил. Назавтра новая сессия кладёт запросы прямо в сервис, заводит колонку cancelled_at и забывает про журнал, рассказывает Сергей Прощаев, руководитель направления Java и Kotlin в финтехе и электронной коммерции.

Тесты при этом зелёные, отчёт считает правильно. Нарушение не ловится автоматически, и в этом главная проблема.

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

Подход не привязан к одному инструменту. Файл AGENTS.md с декабря 2025 года ведёт Agentic AI Foundation при Linux Foundation, некоммерческом фонде открытых проектов. К тому моменту файл использовали больше 60 тысяч открытых проектов.

22 октября 2026 года туда же передали Agent Skills, наборы подключаемых инструкций для агентов. По данным Anthropic, их поддерживают больше 70 агентских платформ.

Что понадобится?

• Агент для программирования. В эксперименте это Codex CLI версии 0.166.0, то есть вариант, которым управляют командами в терминале, с моделью gpt-6.1-sol.
• Проект, у которого уже есть свои соглашения. У автора это сервис на Python 3 с базой SQLite, миграциями (файлами, которые по шагам меняют структуру базы), своим логгером и классом ошибок AppError.
• Документация вашего агента. Claude Code держит правила в CLAUDE.md, Gemini CLI по умолчанию читает GEMINI.md, а AGENTS.md подключается настройкой context.fileName.
• Время на несколько пробных сессий с нуля.

Пошаговая инструкция: как записать решения, которые агент не забудет

1. Выпишите решения, которые агент не выведет из кода. Про каждую договорённость задайте вопрос: сделает ли агент так сам, глядя на код? Проверяйте это сессией без правил, а не догадкой.
2. Запишите решение с причиной и признаком нарушения. Правило без причины агент выполнит буквально и сломает соседний случай, а правило без признака нельзя проверить. Название решения пишите жирным в одну строку, запрещённое называйте прямо.
3. Предупредите про старый код. Если существующий код правилу не соответствует, скажите это в самом правиле. Иначе агент возьмёт за образец, например, коды ошибок bad_email из users.py.
4. Вынесите краткие общие правила в корневой AGENTS.md, то есть в файл в главной папке проекта.
5. Проверьте файл чистой сессией. В эксперименте каждый запуск шёл во временной папке с флагом --ephemeral, без истории прошлых диалогов. Личные инструкции и skills автора в такие сессии не попадали, этому посвящён отдельный шаг в его разборе.

Формат записи из второго шага у автора выглядит так:

## Решения
1. **SQL только в `app/db.py`.** Остальные модули вызывают функции `db`, сами `sqlite3` не импортируют и `execute` не вызывают.
2. **Состояние — поле `status`.** Колонки-флаги вида `cancelled_at`, `is_active` не заводятся. Причина: состояний становится больше двух, и флаги начинают противоречить друг другу.
3. **Каждое изменение данных — в журнал аудита.** Старый код в `users.py` журнал пока не пишет, новый пишет обязательно. Причина: требование безопасности.

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

Что делать с этим прямо сейчас, по ролям

Автору Дзена. Принцип работает и вне программирования: соберите в один документ правила своего канала (тон, запреты, формат заголовков) и вставляйте его в начало каждого нового чата. Записывайте каждое правило с причиной.

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

Предпринимателю. О доступности Codex в России источник не пишет. Сам приём с файлом правил не зависит от конкретного агента, поэтому начинать можно с того инструмента, который у вас уже работает.

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