Модуль 3 из 12 · 13 мин

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

Опубликовано 01/10/2026 · Обновлено 01/10/2026

Кратко

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

На какие вопросы отвечает эта страница 5

Шаг 1 из 8 Что вы поймёте

Схема: файл правил AGENTS.md в папке проекта как памятка новичку, помощник читает её перед каждой задачей
Файл правил это памятка новичку в папке проекта
Что вы поймёте Вы создадите файл AGENTS.md и проверите, что помощник действительно читает ваши правила.

Слова, которые встретятся

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, вставьте заготовку ниже, замените описание и команды на свои, лишние пункты удалите и сохраните.

Markdown Заготовка AGENTS.md
# Правила проекта

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

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

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

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

Вы увидите: файл 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 и работай по нему».

Скриншот: Файл правил в редакторе: в Claude Code он называется CLAUDE.md, внутри короткий список правил
Файл правил в редакторе: в Claude Code он называется CLAUDE.md, внутри короткий список правил
Вы увидите: для вашего инструмента есть понятный способ подключить файл.

Шаг 8 из 8 Проверь себя

1Где должен лежать файл AGENTS.md?

2Что лучше написать в файле правил?

3Можно ли вставлять в AGENTS.md пароли и ключи?

Частые вопросы

Что такое AGENTS.md?

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

Для чего нужен AGENTS.md и что в него писать?

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

Где должен лежать файл AGENTS.md?

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

Чем AGENTS.md отличается от CLAUDE.md и других файлов правил?

AGENTS.md задуман как общий формат для разных инструментов, а у отдельных сервисов бывают собственные имена файлов. Курс учит одному файлу AGENTS.md. Если ваш инструмент его не читает, в модуле есть короткая оговорка и ссылка на документацию, как подключить его в вашей программе.

Как написать первый AGENTS.md за пять минут?

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

Если нужно глубже

Разобрать, где ИИ-помощник сэкономит время именно вам: бесплатный аудит, 30 минут.

Записаться →

если хочется, чтобы файлы правил настроили за вас, 9 900 ₽

Стартовый пакет: общие правила для ИИ уже на вашем компьютере →
Владимир Кулиев

Об авторе

Меня зовут Владимир Кулиев. Сначала я занялся вайбкодингом сам: собрал себе сайты, ботов и автоматизацию. Теперь делаю такое же для клиентов.

  • 13 лет веду свою кайт-школу, 2000+ клиентов
  • Собрал публикатор для нескольких площадок и Telegram-бота с метками для рекламы
  • Настраиваю Яндекс Директ и Яндекс Бизнес
  • Строю SEO-систему для собственного сайта

Что собрал

Все кейсы

Клиентов показываю без названий.

Остались вопросы по курсу?

Напишите мне в Telegram: подскажу, с чего начать. Или оставьте заявку, я отвечу сам.

Claude CodeChatGPTAntigravityVS CodeGeminiCodexGigaChatYandexGPT
Хватайте и бросайте

Или оставьте контакты, я свяжусь

Напишите, что не получилось или что хотите настроить.

Данные нужны только для ответа вам

Форма работает с включённым JavaScript. Напишите мне в Telegram или позвоните +7 909 457‑10‑62.