AGENTS.md: файл правил проекта, чтобы ИИ-помощник знал вашу работу

AGENTS.md это обычный текстовый файл в корне проекта с памяткой для ИИ-помощника: как запускать проект, как проверять изменения, какие у вас правила и чего не трогать. Формат открытый, его читают многие инструменты для кода. Файл можно открыть и поправить в любом редакторе.

Зачем он нужен? Без него помощник каждый раз заново гадает, как у вас принято. С файлом он с первой минуты знает ваши правила, как новый сотрудник, которому выдали памятку.

Вы увидите: пока ничего не меняется. В следующих шагах вы разберётесь, где лежит файл и что в нём писать.

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

Если в проекте есть вложенные части, например отдельная папка сайта и отдельная папка бота, в подпапке может лежать свой файл с уточнениями для этой части. Тот, что ближе к редактируемому файлу, имеет приоритет.

мой-проект/
├── AGENTS.md          <- общие правила проекта
├── README.md
├── сайт/
│   └── AGENTS.md      <- уточнения только для сайта
└── бот/

Вы увидите: в списке файлов вашего проекта AGENTS.md стоит рядом с README.md, а не внутри глубокой папки.

Файл избавляет от повторных объяснений: помощник читает его при старте и знает ваши правила. Пишите коротко: что за проект, команды запуска и проверки, стиль, запреты, где лежат важные папки.

Держите файл коротким, в пределах пары страниц. Длинный файл помощник выполняет хуже, а у некоторых инструментов есть ограничение на размер.

Вы увидите: в голове уже собирается список из трёх-пяти правил для вашего проекта.

Откройте папку проекта в редакторе, создайте новый файл AGENTS.md, вставьте заготовку ниже, замените описание и команды на свои, лишние пункты удалите и сохраните.

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

## Что это за проект
Сайт небольшой мастерской: несколько страниц на HTML.

## Как проверять
- Страницы открывай в браузере и смотри, что ничего не поехало.
- Если есть тесты, запускай `npm test` и показывай результат.

## Правила
- Пиши по-русски, коротко и без жаргона.
- Перед правкой скажи, какой файл собираешься менять.
- Не трогай файлы в папке `secrets/`.
- Если не уверен, спроси, а не угадывай.

Позже дополняйте файл по мере ошибок помощника. Допустил ошибку второй раз? Допишите правило.

Вы увидите: файл AGENTS.md появился в списке файлов, а внутри ваши правила.

Запустите инструмент в папке проекта и задайте простой вопрос. Если помощник пересказал ваши правила, файл прочитан.

Какие правила проекта ты видишь в файле AGENTS.md? Перечисли их своими словами.

Вы увидите: помощник называет ваши правила, например про русский язык и папку secrets/.

AGENTS.md задуман как общий формат для разных инструментов, но у отдельных сервисов бывают собственные имена файлов. Курс учит одному файлу AGENTS.md. Ниже, как с ним у популярных инструментов на 01/10/2026.

Если ваша программа не читает файл сама, сначала найдите в её документации, как указать имя файла правил. А пока можно просто начать задачу фразой «прочитай AGENTS.md и работай по нему».

Вы увидите: для вашего инструмента есть понятный способ подключить файл.