Инструкции и файлы проекта

Как сделать правила короткими, проверяемыми и устойчивыми.

Результат

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

Корневой файл инструкций

Укажите назначение проекта, расположение канонических источников, границы приватности, разрешённые папки для результатов, обязательные проверки, действия с подтверждением, доказательства завершения и формат передачи. Имена конкретного кейса, временные сроки и одноразовые запросы оставляйте в постановке задачи.

Действия

1. Запишите правила Codex в корневой AGENTS.md, а правила Claude Code — в корневой CLAUDE.md. Используйте оба файла, только если проект действительно поддерживает обе платформы.
2. Укажите назначение проекта, ответственного человека, разрешённые и запрещённые данные и порядок приоритета источников.
3. Назовите папки для неизменённых входов, промежуточной работы, кандидатов в результаты и доказательств проверки.
4. Зафиксируйте обязательные проверки, доказательства приёмки и формат передачи.
5. Перечислите действия с отдельным подтверждением, особенно публикацию, сообщения, разрушительные операции, новые учётные данные и расширение доступа.
6. Уберите детали одной задачи и правила, выполнение которых нельзя наблюдать или проверить.
7. После каждого изменения инструкций начните или смоделируйте новую сессию и попросите агента назвать действующие правила и область файлов.

Проверка

Новая сессия называет то же назначение, границы данных, порядок источников, разрешённые папки, проверки и точки подтверждения без вставки старой переписки. Инструкции на разных уровнях папок не противоречат друг другу.

Если не получилось

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

Дальше: Навыки, плагины и MCP.