Постоянные инструкции: AGENTS.md

AGENTS.md — открытый Markdown-формат для устойчивых правил агента в репозитории. Codex загружает подходящие файлы автоматически; более близкий к рабочему файлу AGENTS.md уточняет или переопределяет общий.

Официальная документация: Custom instructions with AGENTS.md.

Быстрый старт

В TUI:

/init

Затем отредактируйте scaffold вручную. Хороший файл содержит факты проекта, а не общие пожелания.

# Правила проекта

## Стек
- Node.js 22, TypeScript, npm.
- Исходники: `src/`, тесты: `tests/`.

## Команды
- Установка: `npm ci`.
- Проверка типов: `npm run typecheck`.
- Тесты: `npm test`.
- Сборка: `npm run build`.

## Ограничения
- Не менять публичный API без отдельного согласования.
- Не выполнять commit и push автоматически.
- В финале перечислить изменённые файлы и фактические проверки.

Уровни

• ~/.codex/AGENTS.md — личные defaults для всех проектов.
• <repo>/AGENTS.md — соглашения всего репозитория.
• <repo>/package/AGENTS.md — правила конкретного subtree.

Не копируйте большую глобальную инструкцию в каждый репозиторий. Держите корневой файл короткой картой, а подробные runbooks — в docs/ с явными ссылками.

Что не стоит писать

• Секреты и реальные credentials.
• Непроверенные команды deploy или очистки данных.
• Большие учебники, не относящиеся к репозиторию.
• Правила, которые должен обеспечивать formatter, тест или CI.
• Временную цель одного чата — она относится к prompt или /goal.

Проверка

Попросите Codex:

Покажи применимые AGENTS.md для текущей папки, их порядок и кратко
перечисли фактические команды проверки. Ничего не меняй.

Если инструкция не применяется, проверьте текущую папку, имя файла, границы Git root и доверие к проекту.