CLAUDE.md: договор с агентом

Коротко: CLAUDE.md - главный файл проекта, который агент автоматически читает в начале каждой сессии. Это карта офиса для нового сотрудника: что за проект, структура папок, правила и где что искать. Держите его коротким, примерно до двухсот строк.

Карта офиса для новенького

CLAUDE.md - файл в корне проекта, который агент читает в начале каждой сессии, автоматически. Представьте: открыли новый чат - пришёл новый сотрудник, ничего не знает. Дали ему карту офиса - он сразу понимает, куда бежать. Это и есть CLAUDE.md.

Держите его коротким, примерно до двухсот строк. Всё, что длиннее, сжигает контекст при каждом запуске и замедляет агента.

Не /init, а свой шаблон

У агента есть команда /init, которая создаст CLAUDE.md автоматически. Но он получится дежурным, «как у всех»: туда не попадут ваши папки, правила, безопасность. Сильный CLAUDE.md пишется под ваш метод.

Вот рабочий шаблон. Скопируйте его, попросите агента заполнить скобки и адаптировать под проект:

# [НАЗВАНИЕ ПРОЕКТА] - карта проекта

Читай этот файл в начале каждой сессии.

## Что это
[Одно предложение: что за проект и для кого.]
Подробности - в business/INDEX.md.

## Порядок чтения
1. business/INDEX.md - что мы делаем: продукт, аудитория, цели.
2. Этот файл - правила и структура.
3. Файл текущей задачи из plans/, если работаем над фичей.

## Структура
[Дерево папок проекта с пояснением в одну строку на папку.]

## Где что искать
| Вопрос | Файл |
|---|---|
| Продукт, тарифы, цены | business/products/ |
| Аудитория и её боли | business/audience/ |
| Цели и метрики | business/goals/ |
| Текущая фича | plans/ - файл со статусом «в работе» |

## Стек
[Технологии проекта. Не знаете - напишите: «выбери сам и зафиксируй здесь».]

## Правила
1. Большая фича - сначала план в plans/, потом код.
2. Не хардкодить цены, даты и цифры - им место в business/.
3. Не деплоить и не публиковать без моей явной команды.
4. Секреты только в .env. Файл .env не читать и не выводить.
5. После каждой фичи - проверка ошибок и security review.
6. Чего не хватает - спрашивай у меня, не выдумывай.

## Язык
Отвечай на русском. Не использовать длинное тире.

Почему это работает

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

Короткая проверка: выберите ответ и нажмите «Проверить».