Правила проекта для Codex: как AGENTS.md удерживает стиль, команды и проверки
Когда Codex работает без правил, он начинает угадывать. Иногда угадывает хорошо. Иногда приносит красивый результат, который не совпадает с тем, как команда реально пишет, проверяет и публикует. Проблема не в “плохом агенте”, а в том, что проектные договоренности остались в голове человека.
В документации OpenAI для этого есть отдельный механизм: AGENTS.md. Codex читает такие файлы перед работой и собирает из них цепочку инструкций: от глобальных привычек до правил конкретной папки. Для владельца проекта это не техническая игрушка, а способ сделать рабочие ожидания видимыми.
Почему устные правила ломаются первыми
Редакция, продуктовая команда или проектный офис часто живут на коротких формулировках: “мы так не пишем”, “перед публикацией всегда проверяем источник”, “не меняй структуру без согласования”, “не трогай продакшн”. Пока рядом есть человек, это работает. Но Codex не слышал прошлые разговоры, если они не попали в контекст.
Каждый раз проговаривать правила в промпте можно, но это быстро превращается в ручную работу. Еще хуже, правила начинают различаться от чата к чату. В одном месте Codex проверяет источники, в другом забывает. В одной задаче уважает стиль журнала, в другой снова пишет как документация.
AGENTS.md нужен, чтобы важные правила жили рядом с проектом, а не в памяти отдельного участника.
Что официально описывает Codex
Документация говорит, что Codex строит instruction chain: сначала глобальный уровень в Codex home, затем проектные файлы от корня до текущей директории. Более близкие к текущей папке инструкции появляются позже и поэтому могут уточнять более общие правила.
Это похоже на редакционную карту:
| Уровень | Что там хранить | Пример для журнала |
|---|---|---|
| Глобальный | личные рабочие привычки | не печатать секреты, не делать опасные команды без причины |
| Проектный | правила всего журнала | SEO не писать в draft.md, статьи публиковать только после audit |
| Локальный | правила конкретной зоны | для Codex-серии русский термин первым, английский только в скобках |
Codex также учитывает лимит размера инструкций. Это полезная дисциплина: AGENTS.md не должен превращаться в энциклопедию. Если файл разрастается, лучше вынести отдельные процессы в skills или соседние документы, а в AGENTS.md оставить правила запуска и проверки.
Что дать Codex на вход
Если вы хотите сделать AGENTS.md полезным, не начинайте с философии. Дайте Codex фактический материал:
- какие действия в проекте повторяются;
- какие ошибки уже случались;
- какие команды или проверки обязательны;
- какие файлы нельзя менять без человека;
- какие слова, стили или форматы нежелательны;
- какие артефакты должны появляться перед публикацией или отправкой.
Запрос может быть простым:
Посмотри на этот проект и предложи короткий AGENTS.md. Мне нужно, чтобы Codex каждый раз помнил: где лежат статьи, какие проверки запускать, что нельзя публиковать без визуала, какие термины писать по-русски и какие решения остаются за редактором.Это запрос не к программисту. Это запрос владельца процесса: превратить рабочие привычки в видимое правило.
Какой артефакт должен вернуться
Хороший результат - не длинный манифест. Хороший результат - короткий файл, который можно прочитать перед работой.
Минимальная структура может быть такой:
- Название файла: AGENTS.md.
- Назначение проекта: коротко объяснить, что это за проект и какой результат считается полезным.
- Рабочие правила: где лежат исходники, черновики и публикационные пакеты; какие проверки обязательны перед публикацией; какие файлы нельзя менять без явной просьбы.
- Стиль результата: как писать заголовки, какие термины переводить и что не должно попадать в публичный текст.
- Человеческие решения: что Codex может подготовить, а что человек должен утвердить.
Для ONFF это напрямую связано с тем, что мы уже делаем в серии про Codex: есть рабочий кабинет проекта, есть автоматизации без хаоса, есть публикационные gates. AGENTS.md удерживает эти договоренности на входе в каждую задачу.
Как проверить AGENTS.md без программирования
Проверка очень простая: прочитайте файл как инструкцию новому сотруднику. Если новый человек после чтения понимает, что делать, что не делать и чем проверять результат, файл работает. Если файл звучит как лозунг, Codex тоже будет трактовать его широко.
Есть пять признаков хорошего AGENTS.md:
- В нем есть конкретные команды или проверки, если они действительно нужны.
- В нем названы файлы и папки, а не “материалы проекта”.
- В нем есть запреты, но они объяснены через риск.
- В нем разделены “можно подготовить” и “можно публиковать”.
- В нем нет попытки заменить все skills и регламенты одним большим текстом.
Если правило нельзя проверить, оно слишком расплывчатое. “Пиши хорошо” не правило. “H1: русский термин первым, официальный английский термин только в скобках или в source-абзаце” - правило.
Где AGENTS.md заканчивается и начинаются skills
AGENTS.md отвечает за устойчивые ожидания проекта. Skill отвечает за повторяемую работу. Это разные уровни.
AGENTS.md может сказать: “для статьи нужен текстовый review, визуальный manifest и live audit”. Но сам метод написания статьи лучше вынести в article-writing skill. AGENTS.md может сказать: “заголовки пишем по-русски”. Но способ выбора H1, SEO title, H2-карты и meta description лучше вынести в title skill.
Так контент-завод становится не монолитом, а управляемой редакцией: правила проекта держат рамку, навыки выполняют конкретные работы, ArticleFactory только разносит готовые пакеты.
Человеческая граница
Codex может предложить AGENTS.md. Он может заметить повторяющиеся проверки. Он может сократить длинные правила. Но человек решает, какие правила действительно обязательны.
Это особенно важно для публикаций. Codex может написать “не публиковать без verified media”. Но только редактор решает, является ли конкретный визуал verified, не теряет ли он смысл статьи и можно ли выпускать материал сейчас.
AGENTS.md - это не способ отдать контроль агенту. Это способ объяснить агенту, где контроль начинается.
