AGENTS.md как операционная дисциплина: десять правил Вайбхава Шристава из OpenAI

Увидел пост Вайбхава Шристава, developer advocate из OpenAI и бывшего Hugging Face. Он напомнил про простую вещь, о которой многие забывают: AGENTS.md нужно регулярно обновлять.

VB — один из самых заметных голосов в open-source AI-сообществе. Четыре года в Hugging Face работал над инференсом, LLM и аудиомоделями, в том числе над Distil-Whisper, сейчас в OpenAI. В своём посте он показал свой глобальный AGENTS.md — файл, который агент читает перед каждой сессией. Это не свалка из ста инструкций, а десять коротких правил. Вот они полностью, в моём переводе.

Обновляйте свой AGENTS.md регулярно! Вот мой:

1. Объясняя что-то пользователю, используй Visualize skill.
2. Будь краток, прям и честен. Оспаривай слабые допущения и отделяй проверенные факты от неопределённостей.
3. Опирай исследования на авторитетные, актуальные источники и ссылайся на важные доказательства.
4. Сохраняй исходную цель и ограничения; доводи авторизованную работу до конца и проверяй реальный результат, прежде чем заявить о завершении.
5. Задавай вопросы только тогда, когда решение действительно неоднозначно, рискованно или требует одобрения.
6. Используй релевантные скиллы; запускай субагентов только для по-настоящему независимой работы и синтезируй их находки.
7. Держи изменения сфокусированными и простыми. Избегай несвязанных правок, ненужных абстракций и малоинформативных тестов.
8. Тестируй наблюдаемое поведение, ревьюй существенные изменения и проверяй пользовательскую работу в реальном интерфейсе, когда это применимо.
9. Сохраняй несвязанную работу и никогда не совершай деструктивных, производственных или внешних действий сверх того, что авторизовал пользователь.
10. Сообщай о значимых блокерах, результатах и доказательствах без шумного прогресса.

Здесь нет промпта в привычном смысле. Каждая строка — поведенческое правило. Проверяй реальный результат, отделяй факты от предположений, не выходи за рамки авторизации. Это операционная дисциплина, а не пожелание.

И главное — файл живой. VB прямо говорит: обновляйте свой регулярно. Агент без актуального контекста деградирует до услужливого стажёра, и поддержание AGENTS.md — это, по сути, ревью собственной работы с ним. Сам AGENTS.md при этом уже открытый стандарт, agents.md, который читают Codex, Cursor, Claude Code, Gemini и другие. Один файл — и все агенты ведут себя предсказуемо.

Рекомендую собрать свой. Начните с пяти правил, которые реально меняют поведение агента в ваших проектах, а дальше ревьюйте регулярно, как код.

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

Если тема зацепила, посмотрите, как мы мигрировали собственный AGENTS.md под новую модель и сохранили контроль: Как мы мигрировали AGENTS.md под GPT-5.6 Sol и не потеряли контроль.

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

• Статья: Как мы мигрировали AGENTS.md под GPT-5.6 Sol и не потеряли контроль
• Блог: Вайбкодинг без разрушений: 10 правил рабочего процесса
• База знаний: Контекст-инжиниринг — как собирать рабочий контекст для моделей нового поколения

Если вы настраиваете агента для своей команды и хотите, чтобы он работал предсказуемо, такой файл — хорошая точка разговора. Будет полезно тем, кто выстраивает рабочий контур с ИИ.

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