Вы попросили поправить текст, а агент обновил зависимости и переписал соседний модуль. Даже если изменения полезны сами по себе, задача выполнена с лишним объёмом. Короткие проектные инструкции помогают заранее сообщить, что требуется прочитать, где можно действовать и как подтверждать результат.
Такой файл не должен становиться сборником пожеланий на все случаи. Его задача — дать устойчивые правила, которые применимы к повседневной работе команды.
Почему нужны два названия
Codex использует AGENTS.md, а Claude Code описывает инструкции в CLAUDE.md. У клиентов различаются правила поиска и загрузки файлов. Поэтому одинаковый смысл инструкций не означает, что любой файл автоматически будет прочитан любой средой.
Проверяйте поведение своего клиента по его документации. Если в проекте несколько уровней инструкций, важно установить, какие из них относятся к рабочему каталогу. Не объявляйте правило действующим только потому, что файл сохранили на диске.
Пять вещей, которые стоит определить
| Часть | Что сообщить агенту | Что получает проверяющий |
|---|---|---|
| Контекст | Назначение проекта и основные источники | Основание выбранного решения |
| Границы | Разрешённая область и отдельные внешние действия | Понятный объём изменения |
| Процесс | Что читать и в каком порядке действовать | Возможность увидеть пропущенный этап |
| Проверки | Реальные средства проверки по задаче | Свидетельство результата |
| Отчёт | Что изменено, проверено и осталось неизвестным | Пригодный итог для приёмки |
Слова «всегда делай идеально» не дают проверяемого правила. «Перед изменением прочитай существующий обработчик и связанные проверки» задаёт конкретное действие. При этом инструкции должны соответствовать проекту: несуществующая команда тестов становится источником шума.
Пример для контентного проекта
Ниже авторский текст, который можно адаптировать к своей редакционной работе. Это пример внутри статьи, а не файл, установленный в AI-клиент.
# Правила работы с контентом
## Источники
Сначала прочитай существующие материалы и первоисточники по теме.
Разделяй факт, собственный вывод и неизвестное значение.
Не называй недоступную страницу проверенной.
## Объём
Подготовка статьи означает работу с текстом и источниками.
Установка программ, изменение сайта и публикация являются отдельными действиями.
Сохраняй существующие редакторские правки.
## Проверка
Перед сдачей проверь числа, даты, ссылки и соответствие заголовка содержанию.
Отличай пример от реально выполненного испытания.
Не добавляй выдуманные результаты, цены и авторов.
## Отчёт
Перечисли готовые материалы, источники и оставшиеся ограничения.
Укажи, где лежат тексты и были ли они опубликованы.В таком проекте просьба написать статью об инструменте не означает поручение установить его. Если пользователь отдельно запросит испытание, появится новая задача со своими условиями и результатами. Это полезная граница для любого агента, который способен не только писать, но и действовать.
Что добавить для проекта с кодом
Укажите расположение исходников и действующие команды проверки, взяв их из самого проекта. Сообщите, нужно ли сохранять публичные интерфейсы и как обращаться с незавершёнными изменениями других участников.
Не перечисляйте все возможные проверки как обязательные для каждой правки. Исправление текста и изменение поведения программы требуют разных свидетельств. Лучше сформулировать правило выбора: проверка должна подтверждать именно затронутый результат, а невыполненный этап явно отмечается в отчёте.
Для длительной работы полезно определить короткую передачу контекста: цель, ограничения, изменённые файлы, наблюдаемые результаты, открытые вопросы. Полная история диалога часто затрудняет продолжение; достаточно сведений, которые влияют на следующий шаг.
Как проверить загрузку инструкций
Начните новую задачу в нужном каталоге и попросите назвать применимые правила и их источники, если клиент позволяет это установить. Затем дайте небольшой контрольный запрос. Например, попросите подготовить только черновик текста и проверьте, что внешние действия не выполнялись.
Цитирование правила агентом является полезным свидетельством чтения, но ещё не доказывает соблюдения. Проверять нужно и поведение. Если задача требует только текста, результатом должны быть тексты и отчёт, а не набор незапрошенных изменений среды.
При расхождении ищите причину: другой рабочий каталог, конфликт инструкций, неподходящее имя файла или ограничение клиента. Не добавляйте новые копии правила во все папки без понимания механизма.
Файл инструкций не является системой разрешений
Ограничение «не публиковать» важно записать, но оно не заменяет настройки доступов. Codex и Claude Code имеют собственные механизмы контроля действий. Текстовые инструкции, технические разрешения и наблюдаемое выполнение надо рассматривать отдельно.
Не храните в таких файлах секреты: инструкции могут попасть в контекст модели или в репозиторий. Для ориентира достаточно безопасного описания источника и процедуры доступа.
Для конкретных рабочих сред читайте Codex CLI и Claude Code. Для повторяемого анализа данных полезна статья о скилле CSV и Excel, для организации этапов — Superpowers.
Источники
AGENTS.md в Codex · CLAUDE.md в Claude Code · безопасность Codex · разрешения Claude Code