Промпт для Claude Code и CLAUDE.md: что писать куда

Два слоя контекста решают разные задачи

Постоянный слой отвечает на вопрос «как работать в этом проекте». Разовый слой отвечает «что именно сделать сейчас».

Оба должны быть короткими настолько, насколько позволяет точность. Длинный файл без приоритета затрудняет поиск актуального правила.

Что положить в CLAUDE.md

Укажите назначение проекта, команды установки и тестов, ключевые каталоги, стиль, запретные зоны, работу с секретами и Git. Для монорепозитория можно добавлять вложенные инструкции там, где контекст меняется.

Не включайте токены, пароли, временный статус одной карточки и длинную историю обсуждений.

• как запустить и проверить проект;
• какой файл является источником плана;
• какие архитектурные границы обязательны;
• какие внешние действия требуют разрешения.

Что написать в текущем промпте

Назовите видимый результат, конкретный scope, готовые модули для переиспользования и то, что нельзя менять. Добавьте положительный и отрицательные сценарии приёмки.

Сошлитесь на файл плана вместо копирования его целиком, если агент может прочитать репозиторий.

Пример разделения

В CLAUDE.md: «коммиты на русском; перед push спросить; PostgreSQL не публикуется; изменения через миграции». В задаче: «добавь фильтр заказов по offer_code, не меняя оплату; проверь два неизвестных значения и mobile».

Так постоянная политика не смешивается с текущим продуктовым результатом.

Как обрабатывать противоречия

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

Не пытайтесь решить конфликт скрытым исключением. В репозитории должен остаться один понятный источник.

Как поддерживать CLAUDE.md

Удаляйте устаревшие команды и объединяйте повторяющиеся правила. Проверяйте файл после изменения структуры, CI и release-процесса.

Хорошее правило описывает ожидаемое поведение и источник истины. Пожелания вроде «пиши идеальный код» не помогают.

Как проверить постановку перед запуском

Попросите агента кратко назвать прочитанные инструкции, scope и критерий завершения, если задача рискованная. Затем разрешите реализацию без бесконечного пересказа плана.

Effort может структурировать разовую задачу, но постоянные правила проекта владелец хранит и проверяет отдельно.