Что такое файл инструкций агента

AGENTS.md и CLAUDE.md - это файлы-инструкции для ИИ-агента кодинга. Простой markdown, который лежит в корне репозитория и описывает проект: что это, как его собирать и тестировать, какой стиль кода, какая архитектура, какие ограничения и чего делать нельзя.

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

Зачем это нужно

Без такого файла агент каждый раз начинает с чистого листа. Не знает, какой командой запускать тесты, путает стиль, добавляет лишние зависимости, лезет туда, куда не надо. Вы объясняете одно и то же в каждой новой сессии.

С файлом инструкций агент сразу знает проект и работает аккуратнее.

Чем это отличается от обычного промпта

Промпт вы пишете заново каждый раз. Файл инструкций агент подхватывает автоматически - это не разовое сообщение, а постоянный контекст проекта. Вы правите его как код: коммитите в репозиторий, и вся команда (и все агенты) работают по одним правилам.

Что рядом

• Скиллы - это отдельные навыки агента, которые он подключает под конкретную задачу. Файл инструкций - это общие правила, скилл - инструмент под задачу. Подробнее в гайде skills.
• Права агента определяют, что ему вообще разрешено делать (запускать команды, менять файлы, ходить в сеть). Это другой механизм - см. права агента. Файл инструкций задаёт правила поведения, права - границы возможностей.