Постоянные правила в AGENTS.md
Зачем это изучать
Вы перестанете повторять Codex одни и те же правила и сможете заранее указать, как правильно проверять именно ваш проект.
AGENTS.md — обычный текстовый файл с постоянными инструкциями для Codex. Название нужно писать точно. Формат Markdown означает простой текст с заголовками и списками, как на этой странице.
Codex ищет такие файлы от общих папок к текущей. Правило в более близкой папке уточняет правило из родительской.
Быстрая практика
Откройте проект в терминальном режиме Codex и выполните:
/initCodex подготовит черновик. Прочитайте его и оставьте только проверенные сведения.
# Правила проекта
## Из чего сделан проект
- Node.js 22 и TypeScript.
- Исходные файлы: `src/`.
- Проверки: `tests/`.
## Как проверить результат
- Установить зависимости: `npm ci`.
- Запустить тесты: `npm test`.
- Собрать проект: `npm run build`.
## Ограничения
- Не публиковать сайт без прямой просьбы.
- Не создавать коммит автоматически.
- В конце перечислить изменённые файлы и выполненные проверки.Если не знаете, что означает команда, не добавляйте её наугад. Спросите автора проекта или попросите Codex найти команду в README.md и ничего не менять.
Где может лежать файл
| Место | Где действует |
|---|---|
| Личная папка настроек Codex | Во всех ваших проектах |
| Корень проекта | Во всём проекте |
| Вложенная папка проекта | Только в этой папке и ниже |
Корневой файл лучше сделать короткой картой. Большие объяснения положите в папку docs/, а из AGENTS.md дайте на них внутренние ссылки.
Что не нужно писать
- пароли, ключи и другие секреты;
- непроверенные команды удаления или публикации;
- временную цель одного диалога;
- длинный учебник, не относящийся к проекту;
- пожелание, которое надёжнее проверяет тест или программа форматирования.
Как проверить правила
Попросите Codex:
Покажи, какие AGENTS.md действуют в текущей папке, в каком порядке они
прочитаны и какие команды проверки из них следуют. Ничего не меняй.