Кратко
AGENTS.md это обычный текстовый файл в корне проекта с памяткой для ИИ-помощника: как запускать проект, как проверять изменения и чего не трогать. Один такой файл понимают многие инструменты для кода, поэтому правила не нужно писать заново для каждого.
На какие вопросы отвечает эта страница 5
Шаг 1 из 8 Что вы поймёте

Слова, которые встретятся
- AGENTS.md
- обычный текстовый файл с правилами для ИИ-помощника, лежит в папке проекта
- Корень проекта
- самая верхняя папка вашего проекта, в которой лежат все остальные файлы
- Markdown
- простой способ оформить текст: решётка для заголовка, дефис для списка; файлы с окончанием
.md - Контекст
- всё, что помощник видит во время работы, и файл правил попадает туда первым
Шаг 2 из 8 Что такое AGENTS.md?
AGENTS.md это обычный текстовый файл в корне проекта с памяткой для ИИ-помощника: как запускать проект, как проверять изменения, какие у вас правила и чего не трогать. Формат открытый, его читают многие инструменты для кода. Файл можно открыть и поправить в любом редакторе.
Зачем он нужен? Без него помощник каждый раз заново гадает, как у вас принято. С файлом он с первой минуты знает ваши правила, как новый сотрудник, которому выдали памятку.

Шаг 3 из 8 Где должен лежать файл AGENTS.md?
Файл кладут в корень папки проекта, рядом с главными файлами. Имя пишется ровно так, заглавными буквами, с окончанием .md. Если положить его в другое место, инструмент может его не увидеть.
Если в проекте есть вложенные части, например отдельная папка сайта и отдельная папка бота, в подпапке может лежать свой файл с уточнениями для этой части. Тот, что ближе к редактируемому файлу, имеет приоритет.
мой-проект/
├── AGENTS.md <- общие правила проекта
├── README.md
├── сайт/
│ └── AGENTS.md <- уточнения только для сайта
└── бот/AGENTS.md стоит рядом с README.md, а не внутри глубокой папки.Шаг 4 из 8 Что писать в AGENTS.md, а что нет?
Файл избавляет от повторных объяснений: помощник читает его при старте и знает ваши правила. Пишите коротко: что за проект, команды запуска и проверки, стиль, запреты, где лежат важные папки.
| Хорошее правило | Плохое правило |
|---|---|
| Перед правкой назови файл, который собираешься менять | Будь умным и аккуратным |
Тесты запускай командой npm test | Пиши качественный код |
Папку secrets/ не открывай | Не делай ничего опасного |
Пароли и ключи в файл не кладите
Файл лежит в проекте и может попасть в чужие руки: в архив, в репозиторий, в пересылку коллеге. Пишите «ключи лежат в файле .env, его не открывай», а сами ключи туда не вставляйте.
Держите файл коротким, в пределах пары страниц. Длинный файл помощник выполняет хуже, а у некоторых инструментов есть ограничение на размер.
Шаг 5 из 8 Как написать первый AGENTS.md за пять минут?
Откройте папку проекта в редакторе, создайте новый файл AGENTS.md, вставьте заготовку ниже, замените описание и команды на свои, лишние пункты удалите и сохраните.
# Правила проекта
## Что это за проект
Сайт небольшой мастерской: несколько страниц на HTML.
## Как проверять
- Страницы открывай в браузере и смотри, что ничего не поехало.
- Если есть тесты, запускай `npm test` и показывай результат.
## Правила
- Пиши по-русски, коротко и без жаргона.
- Перед правкой скажи, какой файл собираешься менять.
- Не трогай файлы в папке `secrets/`.
- Если не уверен, спроси, а не угадывай.
Позже дополняйте файл по мере ошибок помощника. Допустил ошибку второй раз? Допишите правило.
AGENTS.md появился в списке файлов, а внутри ваши правила.Шаг 6 из 8 Как проверить, что помощник прочитал файл?
Запустите инструмент в папке проекта и задайте простой вопрос. Если помощник пересказал ваши правила, файл прочитан.
Какие правила проекта ты видишь в файле AGENTS.md? Перечисли их своими словами.secrets/.Если не получилось
Помощник отвечает, что файла нет
Проблема
помощник не видит AGENTS.md.
Решение
проверьте, что вы запустили инструмент из корня проекта, а не из папки выше или ниже. Закройте инструмент, перейдите в нужную папку и запустите заново. Проверьте и название: AGENTS.md, без пробелов и лишних букв.
Шаг 7 из 8 Что делать, если мой инструмент не читает AGENTS.md?
AGENTS.md задуман как общий формат для разных инструментов, но у отдельных сервисов бывают собственные имена файлов. Курс учит одному файлу AGENTS.md. Ниже, как с ним у популярных инструментов на 01/10/2026.
AGENTS.md в разных инструментах (проверено 01/10/2026)
Claude Code
AGENTS.md
свежие версии читают файл сами, если в проекте нет другого файла правил для этого инструмента
Codex CLI
AGENTS.md
читает из папки проекта и из своей домашней папки
Cursor
AGENTS.md
в корне и в подпапках
Antigravity
AGENTS.md
также читает GEMINI.md и папку .agents/rules
Gemini CLI
GEMINI.md
по умолчанию свой файл; AGENTS.md включается настройкой context.fileName
OpenCode
AGENTS.md
в корне проекта и в общей папке настроек
Aider
проверьте в документации
сам не ищет, подключается командой /read AGENTS.md
Если ваша программа не читает файл сама, сначала найдите в её документации, как указать имя файла правил. А пока можно просто начать задачу фразой «прочитай AGENTS.md и работай по нему».

Шаг 8 из 8 Проверь себя
1Где должен лежать файл AGENTS.md?
2Что лучше написать в файле правил?
3Можно ли вставлять в AGENTS.md пароли и ключи?
