CLAUDE.md: паспорт проекта для агента

Вчера вы с агентом договорились: кнопки лаймовые, тексты на «ты», файл со стилями не трогаем. Сегодня открываешь новую сессию — и он красит кнопки в синий, пишет «вы» и лезет ровно в тот файл. Он не вредничает. Он вообще не помнит, что вчера было. Чиним это одним файлом.

С этого урока начинается модуль про голову агента: как она устроена, почему «забывает» и как сделать, чтобы помнила. Работать будем на живом проекте — том самом, что ты собрал в модуле 2. Если его ещё нет, вернись к уроку про первый проект и собери, без него практика не взлетит.

Почему у агента каждый день — первый рабочий день

Вот что происходит на самом деле. Пока сессия открыта, агент держит ваш разговор в рабочей памяти. Закрыл сессию или нажал /clear — память стёрлась. Полностью. Новая сессия для агента — как первый день на новой работе: код видит, а истории, договорённостей и твоих причин не знает.

И начинается знакомое:

ты

Добавь на сайт секцию с отзывами.

Claude

Готово! Я создал новый файл styles-new.css и подключил его к странице.

ты

Стоп. У нас же все стили в одном файле, мы это ещё на прошлой неделе решили…

Claude

Понял, извини. Перенёс стили в основной файл.

Знакомо? Дубли файлов, забытые правила, переспрашивание одного и того же. Агент забывает не потому, что глупый — у него между сессиями просто нет памяти. Каждый раз ты платишь за это время: объясняешь заново, откатываешь лишнее, ловишь дубли.

Хорошая новость: лечится это за полчаса. Один текстовый файл — и агент начинает каждую сессию уже «в курсе».

Почему у агента каждый день — первый рабочий день

Продолжение — для участников клуба