1. Поделиться картой с Саней
После личного триумфа Тёма возвращается к порталу — и впервые не с нуля. У него на руках сырая PROJECT_NOTE, которую он набросал днём. Он переписывает её начисто — уже не «каракули для себя», а понятная записка: что за проект, какие зоны, где что несущее, куда страшно лезть наобум.
Он перечитывает — и ловит мысль:
— Слушай, а записка-то хорошая вышла. Жалко, что только для меня. Думаю Сане она была бы полезна — я б ему тогда каждый раз не объяснял, что тут где.
— А это можно, — оживляется Лёха. — Ты и так её подаёшь Сане через @, когда вспомнишь, конечно. Но есть способ лучше: сделать так, чтоб агент читал эту записку сам, в начале каждой сессии, без твоих напоминаний. Кладёшь её в проект под особым именем — .claude/CLAUDE.md — и всё.
— Погоди. А чем оно тогда от моей PROJECT_NOTE отличается? Обе же про проект.
— Только тем, как они попадают в ленту. PROJECT_NOTE ты держишь для себя и подаёшь руками, через @, когда вспомнишь. А CLAUDE.md лежит в специальной папке — .claude, и ИИ-агент сам читает и дописывает его в начало ленты в каждой новой сессии. Помнишь три вещи в файле-истории? Там последний пункт - Правила проекта, — это ровно он и есть. Написал один раз — агент читает всегда, сам.
Тёма кивает — картинка складывается и ещё один элемент встаёт на место. Не новая магия, а та же лента сообщений: просто один файл в неё кладётся сам, каждый раз.
— А что туда класть, кроме описания зон?
— Тут интересное. Не только «что за проект». В CLAUDE.md кладут три сорта вещей, — Лёха загибает пальцы. — Первое — про проект: на чём собран, какие команды сборки и тестов, где какие зоны. Второе — как с тобой работать: вплоть до в каком тоне отвечать, на «ты» или на «вы», как тебя звать. Третье — границы: что несущее, куда лезть опасно. То есть не просто «вот проект», а «вот проект, вот как со мной общаться, вот куда не суйся».
2. С чего начать пустой CLAUDE.md
— Ну давай заведу, — Тёма создаёт пустой CLAUDE.md, и тут же скисает. Курсор мигает в пустоте. — И… чего писать-то? С чего начинать. Сесть и с нуля накатать правила на весь проект — это ж тоска смертная. Так ещё и ответственности больше - теперь это не только для него документ, но и важная инструкция для ИИ.
— О, вот это знакомый страх, — усмехается Лёха. — Пустой файл всех парализует. Держи два лайфхака, чтоб не писать с нуля.
Лайфхак первый — наговори голосом. — Помнишь утилиту голосового ввода, Handy? Не печатай — наговори. Создай README.md файл в проекте и просто вслух, как мне сейчас, расскажи: что строишь, что тут важно, чего боишься трогать, как тебе удобно работать. Оно само напечатается.
Тёма оживляется — печатать длинное он не любит, а наговорить куда проще. Зажимает клавишу и проговаривает всё, что днём выяснил про портал: зоны, что несущее, куда не лезть. Текст сыплется в README.md сам.
— Есть черновичок, — говорит он. — Кривой, но живой. Только это README, а не CLAUDE.md.
Лайфхак второй — дай агенту собрать каркас. — А теперь не переноси руками. Есть команда, которая сама просканирует проект и соберёт стартовый CLAUDE.md за тебя:
/init— Она пройдёт по порталу — увидит, на чём собран, какие команды сборки и тестов, какая структура зон, — да ещё и прочитает твой наговорённый README и учтёт его. Соберёт из всего этого аккуратный черновик CLAUDE.md в корне. Тебе останется только пробежать глазами и дописать своё.
Тёма запускает /init. Агент сканирует репозиторий и собирает первый черновик: стек и команды он вытащил из кода сам, а описание зон и «куда не лезть» — подхватил из наговорённого README. В корне появляется черновик CLAUDE.md, и там уже почти всё, что нужно. Тёма открывает, пробегает глазами, дописывает руками пару уточнений про хрупкие зоны — и перекладывает файл на его законное место, в папку .claude/, откуда агент читает его сам:
# CLAUDE.md
Проект: launch-портал клиента (ретро-аркадная промо-кампания).
Стек и команды: npm run build (сборка), npm test (тесты).
Зоны: витрина (pages/ + assets/), reward-flow, leaderboard, bonus-game, partner-зоны.
Несущее: витрина и reward-flow. Хрупкое: partner-зоны — вслепую не трогать.— Видишь, — усмехается Лёха. — Никакого чистого листа. Наговорил мысли в README голосом, /init прочитал и код, и твой README и собрал каркас, ты только пробежался и уточнил. Пустой файл больше тебя не пугает.
3. Как задать агенту манеру общения
Тёма разглядывает готовый файл — и замечает, что чего-то не хватает. Агент по нему теперь знает проект, но общается всё так же сухо, по-казённому. И тут Лёха подкидывает:
— А хочешь фокус? Допиши в самый низ одну строку — как тебе обращаться.
Тёма дописывает:
Обращайся ко мне неформально, на «ты», зови Тёмой.Сохраняет, открывает новую сессию — и агент с первого же ответа стал своим: по имени, в том самом тоне, без канцелярщины. Одна строка в текстовом файле — и характер поменялся.
— О, а это вообще огонь, — смеется Тема.
Характер агента — это просто текст, который можно переписать. Тон, язык, обращение, правила работы — всё строки в файле, а не зашитая где-то намертво настройка. Не нравится — поменял строку. Хочешь построже — дописал. Никаких недр, никаких конфигов.
Леха предлагает проверить, как ИИ отвечает с учетом наличия CLAUDE.md
Что тема сразу и делает — спрашивает агента в лоб, нарочно без контекста:
На чём собирается проект и какие тут зоны?И агент отвечает сразу, не переспрашивая, — потому что прочитал CLAUDE.md . Объяснил проект один раз — больше не повторяешь. И не разово: так теперь будет всю жизнь проекта.
— Кстати, — роняет Лёха мимоходом, — кроме этого файла, который пишешь ты, у агента есть ещё и своя память между сессиями — он сам подкапливает какие-то факты и поправки. Заглянуть в неё можно так:
/memory— Но это на потом. Сейчас просто знай, что она есть и её можно посмотреть. Разберём её позже, отдельно — там свои тонкости.
ПЕРЕЙДИТЕ В ПОЛНУЮ ВЕРСИЮ