Промт: пусть агент сам составит AGENTS.md / CLAUDE.md по вашему проекту

Этот промт просит агента изучить репозиторий, задать вопросы о том, чего не видно в коде, и составить AGENTS.md: команды, структуру, правила и проверку перед «готово». В конце агент перечисляет, что нужно проверить вам. Есть варианты для CLAUDE.md и .cursor/rules.

Составь AGENTS.md для этого репозитория. Файл будут читать разные ИИ-агенты.

1. Изучи проект: README, файлы зависимостей и конфигурации, структуру папок,
   скрипты сборки и тестов, существующие CLAUDE.md, .cursor/rules и другие файлы правил.
2. Задай мне вопросы о том, чего не видно в коде: что запрещено трогать,
   какие решения уже приняты и почему, как проверять результат, где секреты.
   Жди ответов, файл пока не пиши.
3. Напиши AGENTS.md с разделами:
   - о проекте — 2–3 строки;
   - команды: установка, запуск, сборка, тесты, линтер — точно как в проекте;
   - структура: где что лежит, только важное;
   - правила и запреты;
   - секреты: где хранятся, что нельзя коммитить;
   - перед тем как сказать «готово»: какие проверки запустить.
4. Пиши коротко и проверяемо. Не добавляй общих советов вроде «пиши чистый код».
   Не придумывай команды, которых нет в проекте.
5. После файла отдельным списком: что ты предположил и что мне нужно проверить вручную.

Когда пригодится#

Проект уже есть, а файла правил нет: агент каждый раз заново выясняет, как всё запускать.
В проекте лежат CLAUDE.md, .cursor/rules и заметки в README, и правила в них расходятся.
Вы пришли в чужой проект и хотите быстро понять, как он устроен.

Для нового пустого проекта промт мало что даст: изучать нечего. В этом случае возьмите готовый пример со страницы AGENTS.md или из задач сайт и Telegram-бот.

Как устроен промт: изучить → спросить → написать#

Изучить. Команды и структуру агент берёт из проекта, а не из памяти. Поэтому они совпадают с реальными скриптами.
Спросить. В коде не видно, что «папку legacy не трогать» или что «деплой только через CI». Без вопросов агент либо пропустит это, либо придумает.
Написать. Разделы повторяют то, что AGENTS.md должен содержать по описанию на agents.md: обзор проекта, команды сборки и тестов, стиль кода, тесты, безопасность.
Что проверить. Отдельный список предположений — самое полезное в ответе. Именно там прячутся ошибки.

Вариант для CLAUDE.md#

Claude Code читает AGENTS.md, только если в проекте нет CLAUDE.md или CLAUDE.local.md. Чтобы правила были в одном месте, после AGENTS.md добавьте к промту:

Теперь создай CLAUDE.md из одной строки @AGENTS.md.
Ниже добавь только то, что касается одного Claude Code, если такое есть.

Строка @AGENTS.md импортирует файл целиком. Можно вместо этого сделать символическую ссылку ln -s AGENTS.md CLAUDE.md, но на Windows для неё нужны права администратора или режим разработчика, а Git без включённого core.symlinks создаст вместо ссылки обычный файл. Если в команде есть кто-то на Windows, используйте импорт.

Быстрый путь без промта — команда /init в Claude Code. Она создаёт CLAUDE.md по коду проекта и учитывает файлы правил других инструментов.

Вариант для .cursor/rules#

Cursor читает AGENTS.md в корне и во вложенных папках, так что отдельные правила не обязательны. Они нужны, когда правило должно действовать только для части файлов:

Вынеси правила для [папки или типа файлов] из AGENTS.md в отдельное правило
.cursor/rules/[имя].mdc с полями description и globs. В AGENTS.md оставь общие правила.

Расширение должно быть .mdc: обычный .md в .cursor/rules Cursor не читает.

Как проверить черновик#

Команды. Запустите каждую из раздела «Команды» сами. Если не работает — исправьте файл.
Нет общих слов. Каждую строку можно проверить. «Следуй лучшим практикам» удаляйте.
Нет секретов. В файле не должно быть токенов, паролей и адресов внутренних серверов. AGENTS.md лежит в репозитории.
Агент видит файл. Спросите в новом разговоре: «Какие правила проекта ты знаешь?» В Claude Code загруженные файлы показывает /context, в Codex можно выполнить codex --ask-for-approval never "Summarize the current instructions.".

Промт для обновления AGENTS.md#

AGENTS.md устаревает вместе с проектом. Раз в несколько недель или после крупных изменений:

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

Ещё один повод обновить файл — агент дважды ошибся в одном и том же. Значит, этого правила в файле не хватает.

Источники: agents.md, Claude Code — память и CLAUDE.md, Cursor — правила, Codex — AGENTS.md.

Вопросы и ответы

Как быстро создать CLAUDE.md?

В Claude Code выполните команду /init: агент изучит проект и создаст CLAUDE.md с командами сборки, тестов и найденными соглашениями. Если файл уже есть, /init предложит улучшения, а не перезапишет его. Промт с этой страницы полезен, когда нужен AGENTS.md для нескольких агентов или вопросы о том, чего нет в коде.

Как научить агента моему стилю кода?

Запишите стиль в AGENTS.md коротко и проверяемо: «функции до 40 строк», «имена на английском», «форматирование — prettier, запускай перед коммитом». Ещё надёжнее дать команду линтера или форматтера: агент запустит её сам. Расплывчатые пожелания вроде «пиши чисто» почти не работают.

Как не дублировать AGENTS.md и CLAUDE.md?

Держите правила в AGENTS.md, а в CLAUDE.md оставьте строку @AGENTS.md: Claude Code импортирует файл, а ниже можно дописать то, что нужно только ему. Другой вариант — символическая ссылка CLAUDE.md на AGENTS.md, но на Windows она работает не у всех, поэтому импорт надёжнее.

Как настроить AGENTS.md?

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