Чтобы настроить ИИ-агента под проект, не обязательно собирать огромный файл с промптами. Начните с трёх вопросов: какие правила действуют во всём проекте, какой процесс вы повторяете и к каким инструментам агенту нужен доступ. Ответы обычно относятся к разным местам: AGENTS. md или CLAUDE. md, навыку SKILL. md и подключению MCP.
Разберём это на небольшой задаче: нужно изменить форму заявки на сайте онлайн-школы. Сохранить существующие стили, проверить отправку и показать результат на телефоне. Примеры ниже — предлагаемый порядок работы, а не отчёт о личном сравнительном тесте Claude Code, Codex и Cursor. Документация проверена 19 октября 2026 года.
AGENTS.md, SKILL. md и MCP: в чём разница
| Что нужно сообщить | Куда положить | Пример для формы заявки |
|---|---|---|
| Постоянные договорённости проекта | Файл инструкций, который поддерживает ваш агент | Использовать существующие поля и стили, не менять обработчик оплаты |
| Процесс для определённой задачи | Навык с SKILL. md | Проверить форму: пустые значения, ошибку сервера, успешную отправку |
| Доступ к внешним данным и действиям | Подключение MCP в клиенте | Прочитать нужный фрейм Figma или открыть документацию сервиса |
| Требование только к текущей правке | Сообщение агенту | Поменять подпись одной кнопки и показать мобильный вариант |
Эта схема помогает не хранить одно требование в четырёх местах. Если срок акции относится только к сегодняшней задаче, ему не обязательно жить в общих инструкциях проекта. А доступ к макету не появится от фразы «используй Figma» в текстовом файле.
Что такое AGENTS. md и где здесь CLAUDE. md
AGENTS.md — файл с рабочими инструкциями для агента. В документации Codex описаны поиск файлов от корня проекта к рабочему каталогу и приоритет более близких инструкций. Для своего клиента нужно проверить именно его порядок загрузки: одинаковое имя файла не гарантирует одинаковое поведение.
Cursor поддерживает AGENTS. md в корне и подпапках проекта. Его Project Rules — отдельный механизм с дополнительными настройками. Не нужно дублировать каждую строку AGENTS. md во всех форматах: сначала решите, нужен ли вам такой уровень настройки.
У Claude Code есть CLAUDE.md. Начиная с релиза 2.1.277 появилась и поддержка AGENTS.md. Но важны текущая версия и настройка Project instructions, а не только наличие файла.
По актуальной документации Claude Code, режим по умолчанию использует AGENTS. md, если в рабочем каталоге и выше нет CLAUDE. md или CLAUDE.local.md. Совместную загрузку можно выбрать в /config. Если нужен общий источник инструкций и отдельные дополнения для Claude, в CLAUDE. md поддерживается импорт:
@AGENTS.md
Фраза «прочитай AGENTS. md» обычным текстом не равна такому импорту. Не удаляйте существующие инструкции вслепую: сначала выясните, какой файл агент действительно загружает и что в нём ещё хранится.
Небольшой шаблон правил проекта
Вместо описания всей истории сайта оставьте сведения, которые влияют на следующую правку. Вот пример для небольшого проекта на WordPress; пути и команды нужно заменить своими:
# Работа с проектом
Сайт на WordPress. Шаблоны находятся в theme/, стили — в theme/assets/css/.
Перед правкой найди существующий шаблон похожей страницы.
Используй текущие CSS-переменные и компоненты.
Не меняй обработчики оплаты и файлы с данными без задачи на них.
Для изменённых PHP-файлов выполни php -l.
Для изменения формы проверь пустые поля, ошибку и успешный результат.
Укажи, какие проверки выполнены, а какие требуют доступа к серверу.
В конце перечисли изменённые файлы и дай адрес локального превью.
Публикацию и отправку писем выполняй только в согласованной задаче.
Здесь есть устройство проекта, границы работы и способ проверки. Нет придуманной команды npm test, которой в PHP-проекте может вообще не быть. Если настоящие проверки уже описаны в README, лучше дать точную ссылку на раздел, чем поддерживать две расходящиеся копии.
Границы полезно формулировать так же конкретно, как состав работ для клиента: что меняем, что проверяем и какое действие требует отдельного решения. «Работай аккуратно» не объясняет, можно ли переписать соседний экран.
Когда нужен SKILL. md
Навык нужен, когда вы повторяете один процесс в разных задачах: проверяете посадочные страницы, готовите выпуск или приводите таблицу к одному формату. В спецификации Agent Skills описан файл SKILL. md с обязательными полями name и description; к нему могут добавляться инструкции, скрипты и другие материалы.
Расположение папки и дополнительные поля зависят от клиента. Для Claude Code сохраните пример ниже в .claude/skills/review-lead-form/SKILL.md относительно корня проекта: это путь проектного навыка по документации Claude Code. Для других клиентов проверьте расположение в их документации.
Например, такой навык задаёт процесс проверки формы:
---
name: review-lead-form
description: Проверяет форму заявки после изменения полей, валидации или отправки.
---
1. Найди форму и опиши её основной сценарий.
2. Проверь пустую отправку и неверные значения.
3. Проверь ошибку сервера и повторную попытку, если есть тестовое окружение.
4. Проверь успешный результат без настоящей заявки клиенту.
5. Посмотри форму на узком экране и с клавиатуры.
6. Верни найденные проблемы с шагами воспроизведения.
Если нужного окружения нет, назови непроверенные сценарии.
Не объявляй доставку письма проверенной только по уведомлению на странице.
В Claude Code откройте сессию в корне проекта, введите / и убедитесь, что review-lead-form появился в меню. Вызовите /review-lead-form и укажите тестовую страницу с формой. Если навыка нет в меню, проверьте путь и корректность файла по документации установленной версии клиента.
В описании назван повод запуска: изменение формы. Формулировка «использовать при любой работе с сайтом» заставила бы вспоминать о проверке формы даже при замене фавикона.
Сначала навык может содержать только инструкцию. Скрипт имеет смысл добавлять, когда он выполняет устойчивую операцию и его результат можно проверить. Не нужно заранее строить универсальный набор инструментов ради процесса из нескольких понятных действий.
MCP подключает инструмент, но не заменяет задачу
MCP — протокол соединения ИИ-приложений с внешними системами, данными и инструментами. Подключение может дать агенту доступ к макету или документации. Оно само по себе не описывает, какую форму считать правильной и что разрешено менять.
Для нашей задачи сначала укажите конкретный фрейм и желаемое действие. Затем убедитесь, что инструмент чтения доступен и вернул сведения именно об этом фрейме. Если подключение активно, а агент рассуждает только по описанию из чата, данные макета ещё не подтверждены.
Не всякому навыку нужен MCP. Проверку локальной разметки можно выполнить с файлами и браузером. И не всякое подключение требует собственного навыка: иногда достаточно разового запроса с понятным результатом. Добавляйте слой, когда можете объяснить, какую повторяющуюся проблему он решает.
Как проверить инструкции на одной задаче
Возьмите небольшое изменение, которое легко оценить: например, добавить пояснение под полем телефона. Не начинайте проверку конфигурации с полной переделки сайта.
- Откройте новую сессию в нужной папке проекта. Проверьте версию клиента и рабочий каталог.
- Посмотрите, какие инструкции и навыки загрузились. В Claude Code для этого пригодятся сведения о контексте; имя файла в папке ещё не доказывает загрузку.
- Попросите найти существующую форму и назвать предполагаемые изменяемые файлы.
- Выполните маленькую правку и сравните список файлов с задачей.
- Проверьте сценарии формы и сам результат, а не только ответ «готово».
- Исправьте конкретную неясность в инструкции и повторите такую же задачу в новой сессии.
Ответ модели «я прочитала правила» полезен как подсказка, но недостаточен для приёмки. Смотрите доступные записи вызовов, состояние интерфейса, изменения файлов и результаты команд. Если правило требует проверить отправку, а тестового сервера нет, корректный итог — явно обозначенная непроверенная отправка.
В истории моего первого расширения есть пример отдельного законченного инструмента. Для такой работы полезнее короткий проверяемый сценарий, чем обещание сразу предусмотреть всё. А когда процесс выпуска уже сложился, повторяемые шаги можно вынести в автоматизацию через GitHub Actions.
Почему больше инструкций не всегда лучше
В разборе OpenAI от 11 сентября 2026 года отдельно обсуждаются слишком широкие описания навыков, противоречащие инструкции и лишнее чтение материалов. Это причина пересматривать накопленные правила, а не обещание, что короткий файл всегда дешевле и точнее длинного.
Чтобы проверить пользу изменений, сравните похожие задачи: сколько пришлось исправлять вручную, какие проверки агент пропустил и какие лишние действия выполнил. Расход токенов можно сравнивать только при сопоставимых условиях. Без такого измерения фраза «SKILL.md экономит половину бюджета» будет рекламой, а не результатом.
Начните с одного файла правил, одного повторяемого процесса и действительно нужного подключения. Если хотите настроить такой рабочий процесс для сайта, бота или небольшой команды, напишите мне в Telegram: разберём задачу и критерии результата.