Запишите в AGENTS.md, где сайт берёт цены, как работают формы и какие файлы ИИ-агенту нельзя менять без согласования. Тогда перед правкой у агента будет короткая инструкция о вашем проекте, а у вас — понятный список того, что проверить перед публикацией. Ниже есть текст, который можно адаптировать под свой сайт, и способ убедиться, что агент прочитал правила. Начните с формы заявки или страницы с ценами: там ошибка быстро затронет работу бизнеса.
Какие правила нужны сайту в первую очередь?
AGENTS.md — файл с правилами для ИИ-агента, который работает над проектом. Если вы даёте агенту задачу «поправь страницу услуг», ему нужен контекст: где лежит актуальный прайс, какие поля обязательны в форме и когда следует остановиться и спросить владельца сайта. Без этого агенту придётся угадывать по коду. В руководстве о правилах для ИИ-агента отдельно разобраны AGENTS.md, CLAUDE.md, проверка загрузки правил и ограничения доступа (источник: IT-ХОЗЯЕВА).
Начните с трёх зон. Для цен укажите источник, который человек в компании считает актуальным: например, файл прайса или список, который ведёт менеджер. Для форм опишите, что пользователь должен увидеть после отправки и как команда проверяет получение заявки. Для границ правок назовите файлы и решения, которые требуют согласования. Сам агент не знает, кто в вашем бизнесе утверждает новую стоимость услуги.
Правило должно отвечать на действие, а не звучать как пожелание. Вместо «бережно работай с ценами» напишите: «Не меняй сумму и условия оплаты по своей инициативе; если задача затрагивает цену, перечисли затронутые страницы и запроси подтверждение». Так проще заметить, когда агент вышел за рамки задачи.
Как составить AGENTS.md без технического задания на десятки страниц?
Создайте файл AGENTS.md в корне проекта и замените названия страниц и файлов в примере на свои. Если файл уже есть, добавьте недостающие правила в подходящий раздел. Этот текст задаёт агенту порядок работы; он не заменяет проверку сайта человеком.
- «Сайт: [чем занимается бизнес]. Перед правкой коротко назови страницы и файлы, которые планируешь изменить. Не трогай остальные разделы без отдельной задачи».
- «Цены и условия: актуальный источник — [где команда хранит утверждённый прайс]. Если стоимость в коде и источнике различается, остановись и покажи расхождение. Не выбирай значение сам».
- «Формы: сохрани обязательные поля, тексты ошибок и сообщение об успешной отправке. После правки проверь отправку тестовой заявки способом, который указан в проекте. Не отправляй тест через рабочую форму, пока не согласован способ проверки».
- «Границы: не меняй настройки публикации, доступы и файлы вне задачи. Если без такой правки задача не решается, сначала объясни причину и дождись согласования».
- «Перед завершением: перечисли изменённые файлы, выполненные проверки и то, что проверить не удалось. Не называй задачу готовой, если форма или страница с ценой осталась без проверки».
Не вставляйте в AGENTS.md пароли и другие секреты. Агенту достаточно знать, что для проверки формы нужен согласованный тестовый сценарий, а для изменения настроек публикации — разрешение. Если у проекта уже есть CLAUDE.md, сравните инструкции перед работой: противоречащие правила дадут агенту две разные версии задачи. Русскоязычное руководство по Claude Code рассматривает оба инструмента организации работы — инструкции проекта и проверки через хуки (источник: GitHub, sfrangulov/claude-code-handbook-ru).
Для сайта с заявками особенно полезно уточнить, что означает «форма работает». Одного появления сообщения «Отправлено» мало, если команда ждёт заявку в своём рабочем канале. Опишите проверяемый результат и укажите, кто подтверждает его перед публикацией. Если такой проверки пока нет, запишите это как ограничение, а не просите агента считать отправку успешной на глаз.
Как проверить, что агент учёл правила перед правкой?
Попросите агента до изменения кода назвать источник цен, порядок проверки формы и файлы, которые он не станет трогать. Сверьте ответ с AGENTS.md. Если он пропустил правило, остановите задачу и проверьте, видит ли агент файл в своей рабочей папке. Это быстрее, чем обнаружить расхождение после публикации.
Затем дайте узкую пробную задачу: например, исправить текст подсказки у поля формы, не меняя отправку заявки. Посмотрите список файлов, которые агент собирается править. Когда в нём появляются прайс или настройки публикации, попросите объяснить связь с задачей до внесения изменений. Такое согласование особенно важно для сайта, где один и тот же шаблон выводит цену на нескольких страницах.
После правки проверьте результат в браузере. Откройте изменённую страницу на телефоне и убедитесь, что форма и цена видны без обрезки; для этого пригодится отдельный порядок проверки мобильной версии после правок ИИ-агента. Если агент менял подписи полей или сообщения об ошибках, пройдите и проверку доступности сайта после правок Claude Code. В AGENTS.md можно перечислить эти проверки, но факт их выполнения подтверждается только результатом.
Права доступа и автоматические проверки решают другую задачу: они ограничивают действия или останавливают публикацию при ошибке. Текст в AGENTS.md сам по себе не запрещает агенту изменить файл. Если цена или отправка заявок критичны для работы, попросите разработчика настроить технические ограничения отдельно. Правила подскажут агенту, когда остановиться; ограничения помогут удержать границу.
Какие ошибки чаще всего мешают правилам работать?
- «Проверь сайт полностью». Причина: непонятно, где заканчивается задача. Исправление: назовите страницы, форму и конкретный ожидаемый результат.
- «Цены возьми с сайта». Причина: на сайте уже может быть ошибка. Исправление: укажите источник утверждённых цен и действие при расхождении.
- «Форму не ломай». Причина: агент не знает, что проверить. Исправление: опишите путь тестовой заявки и кто подтвердит её получение.
- «Ничего важного не меняй». Причина: для каждого важны разные файлы. Исправление: перечислите настройки и решения, для которых нужно согласование.
- Правила записаны, но их никто не сверяет с ответом агента. Исправление: перед первой правкой попросите агента повторить ограничения своими словами.
Откройте AGENTS.md и за две минуты добавьте одну строку: где находится утверждённый прайс и что агенту делать, если цена на сайте с ним расходится.
