Второй мозг в Claude Code: как настроить, чтобы он помнил проект

Веду эти разборы публично. В канале каждый день - инструменты, рабочие промпты и провалы вайб-кодинга, на которые я налетел сам. Подпишись там, где удобнее:

Зачем второй мозг нужен Claude Code и без чего нельзя обойтись?

Открываешь Claude Code во вторник. Объясняешь: проект такой-то, аудитория такая-то, не делай вот этого. Поработали. В четверг - новый чат, всё то же самое заново.

Если у тебя есть CLAUDE.md - первый круг страданий закрыт. Базовые правила и описание проекта живут в одном файле и грузятся в каждую сессию. Я разбирал, как этот файл устроен, в гайде про CLAUDE.md - можно прочитать его до этого, чтобы фундамент был на месте.

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

Раньше у меня эти знания жили в четырёх местах. В голове, в переписке в Telegram, в документах Google и в головах сотрудников. Через месяц после решения уже никто не помнил, почему его приняли. Новый человек по часу расспрашивал команду, чтобы войти в контекст. Claude в этом контексте не было совсем.

Конкретно: до второго мозга я каждую сессию заново объяснял агенту, кто наш клиент, как устроена оферта, через какого провайдера идут платежи. С business/ открываю чат, говорю «поправь оферту под новый тариф» - Claude сам идёт в business/company/legal.md, читает требования, идёт в business/products/pricing.md, видит новый тариф, и предлагает правку в одном проходе. Разогрев пропал, контекст подгружается автоматически.

Anthropic в инженерном блоге называет эту проблему context rot:

Перевожу: чем больше ты пихаешь в окно, тем хуже агент работает с конкретикой. Решение: держать структуру внешних файлов, на которые Claude ходит сам, по конкретному запросу. Это и называется второй мозг.

Что такое второй мозг и как концепция Tiago Forte ложится на Claude?

Концепция «второго мозга» не моя. Её придумал Tiago Forte, и сформулировал он её в книге Building a Second Brain в 2022 году. Главная цитата оттуда:

У Forte эта идея про продуктивность вообще. Обычные пользователи второго мозга заводят Obsidian-vault, кидают туда выписки из книг, заметки с созвонов, идеи проектов. CODE-метод: Capture - собирай всё, что зацепило. Organize - раскладывай по PARA (Projects, Areas, Resources, Archive). Distill - выжимай суть. Express - превращай в результат.

Когда я перенёс эту идею на работу с Claude Code, она перестала быть про продуктивность и стала про архитектуру агента.

В классическом BASB второй мозг - твой, ты в него ходишь руками. В работе с Claude Code второй мозг становится двусторонним: и ты в него ходишь, и агент. Это меняет требования к формату.

Раз агент туда ходит сам, файлы должны быть в формате, который он понимает без отдельной интеграции. Markdown подходит идеально: текст, иерархия заголовков, ссылки между файлами. Notion и Google Docs - не подходят. Подключить их можно через MCP, но это лишний слой, лишний токен на запрос, лишняя точка отказа.

Раз файлы лежат в файловой системе рядом с проектом - они автоматически попадают в зону видимости Claude Code. Никаких настроек. Запускаешь агент в папке проекта - он видит все файлы внутри. Это бесплатно и работает из коробки.

Какая иерархия памяти у Claude Code из коробки?

Прежде чем добавлять что-то своё, разберём, что Claude умеет помнить без твоих усилий. Anthropic в официальной документации описывает два механизма: CLAUDE.md (правила, которые пишешь ты) и auto memory (выводы, которые пишет сам Claude). Оба грузятся в начале каждой сессии.

CLAUDE.md ищется в четырёх местах одновременно:

Все четыре файла грузятся в контекст. Чем уровень специфичнее - тем выше его приоритет. Локальный читается последним, поэтому его правила перекрывают всё остальное.

Дополнительно в каждой папке внутри проекта может лежать свой CLAUDE.md. Когда Claude читает файл из подпапки, он подгружает CLAUDE.md этой подпапки on-demand. Это удобно для монорепо: правила фронтенда живут в frontend/CLAUDE.md, бэкенда - в backend/CLAUDE.md, и грузятся только когда агент работает с нужной частью.

Auto memory появилась в Claude Code 2.1.59. Это файлы, которые Claude пишет о тебе сам:

~/.claude/projects/<project-name>/memory/
├── MEMORY.md          # Индекс, грузится в каждую сессию (200 строк или 25KB)
├── debugging.md       # Подробные заметки (грузятся по требованию)
├── api-conventions.md
└── ...

В официальной документации Anthropic это описывает так:

Auto memory включается флагом autoMemoryEnabled в ~/.claude/settings.json. Claude сам решает, что туда писать. Ты можешь читать MEMORY.md и редактировать руками - формат обычного markdown.

CLAUDE.md или второй мозг - где провести границу?

Аналогия, которую я даю на эфирах: представь, что нанял нового сотрудника. Что ты ему даёшь в первый день?

Инструкцию: как одеваться, во сколько приходить, в каком тоне отвечать клиентам, через какую систему публиковать. Это короткий документ. Он не объясняет, что вы делаете и почему. Просто говорит, как себя вести.

И отдельно - доступ к корпоративной wiki. Там расписано, что за продукт, для кого, какая аудитория, какая цена и почему, какие конкуренты, какие были ошибки. Это объёмный архив. Никто его целиком не читает - туда ныряют по конкретному вопросу.

CLAUDE.md = инструкция. Второй мозг = wiki. Оба нужны.

Граница простая. В CLAUDE.md идёт всё, что применимо к каждой задаче:

• Кто такой агент в этом проекте (помощник, ведущий, ассистент)
• На каком языке отвечать
• Стек инструментов
• Команды публикации
• Запреты (не использовать длинное тире, не запускать git push --force)
• Маршрутизация: куда нырять за бизнес-контекстом, куда за принципами

Во второй мозг идёт всё, что нужно по требованию:

• Что за продукт, аудитория, экономика, цели
• Конкуренты, рынок
• Прошлые решения и их причины
• Примеры клиентов, отзывы
• Принципы и методология

Anthropic в документации формулирует через те же буквы:

Скиллы - один из способов хранить эпизодические знания. Папка business/ рядом с проектом - другой. Я использую оба, и подробнее разберу ниже.

Из чего состоит мозг проекта - 5 частей плюс машина времени

Сама архитектура, которой я пользуюсь и в smyslokod.ru, и в других проектах:

Ключевой методологический момент - разделение ai-clone/ и business/.

business/ отвечает на вопрос «что мы делаем». Продукт, аудитория, цены, конкуренты. Это про проект. Если завтра ты передашь проект партнёру, эта папка едет с проектом.

ai-clone/ отвечает на вопрос «как я решаю». Мои принципы, мой тон, моё мастерство, мои стоп-слова. Это про меня. Если завтра я начну новый проект, эта папка едет со мной.

Вместе они дают то, что я называю Я-компанией. Один человек плюс структурированный контекст плюс ИИ, который этот контекст читает.

Хочешь не только настроить вторую папку, но и собрать связку, которая делает Claude стабильным? Этого мало. Без ai-clone/ агент отвечает за всех, а не за тебя. Без контекст-инжиниринга он бегает по всей папке и жжёт токены. Все три вещи - второй мозг + ИИ-клон + контекст-инжиниринг - я собираю с участниками на практикуме по смысло-кодингу. Это 3 кита, без которых ИИ галлюцинирует.

Практикум по вайб-кодингу

+Твой второй мозг

3 вечера - стек, метод, первый проект

Старт 26–28 мая  ·  2 000 ₽

Записаться →

Что класть в business/ и чего туда не клади?

Структура business/ верхнего уровня в моём проекте:

business/
├── INDEX.md              ← карта папки, читать первым
├── company/              ← миссия, юрлицо, ценности, юр.регламенты
├── products/             ← продукты, программы, цены
├── audience/             ← портрет клиента, сегменты, возражения
├── goals/                ← цели на год, квартал, месяц, метрики
├── economics/            ← юнит-экономика, доходы, расходы, прогноз
├── marketing/            ← каналы, воронка, материалы, конкуренты
├── execution/            ← планирование недели, бэклог
└── assets/               ← дизайн-система, отзывы, копи-банк

Это пример из моего проекта, а не догма. Папки я завожу по мере необходимости. Я начинал с трёх (products/, audience/, goals/), остальные добавились через 2-3 месяца, когда стало непонятно, куда класть новое.

Главный файл папки - INDEX.md. Это карта. В нём - таблица «вопрос → файл», по которой Claude понимает, куда нырять. Без неё агент тратит токены на чтение всех файлов подряд.

Пример куска INDEX.md:

### Где что искать

| Что нужно | Куда смотреть |
|---|---|
| Кто наш клиент, его боли | `business/audience/avatar.md` |
| Какие продукты, тарифы, цены | `business/products/` |
| Цели и метрики | `business/goals/` |
| Экономика (доход, расход, юнит) | `business/economics/` |
| Каналы продвижения, материалы | `business/marketing/` |

Тогда в CLAUDE.md достаточно одной строки: «Когда вопрос про бизнес - читай business/INDEX.md, дальше идёшь по карте». Агент не грузит всю папку в контекст. Грузит карту, выбирает нужный файл, читает только его.

Чек-лист, чего не класть в business/:

• Сырая переписка из чата без обработки. Если есть инсайт - выжми и сформулируй. Если нет - не клади.
• Дублирующая код информация. «Платежи идут через CloudPayments» - не нужно, агент это увидит в коде.
• Скриншоты и картинки. Они увеличивают вес папки и не парсятся текстовой моделью без отдельного шага.
• Динамические цифры. «Сегодня 423 оплаты по продукту» - устареет через неделю. Используй маркер LIVE и ссылку на запрос к БД.
• Серое и сомнительное. Если завтра репозиторий уйдёт на YouTube перед 100 тысячами незнакомых людей - пусть там лежит то, что ты готов показать. Папку читают сотрудники, агенты, и иногда внешние подрядчики.

Зачем отдельная папка ai-clone и почему её нельзя смешивать с business?

Идея проста: бизнес знает, что мы делаем. Клон знает, как я это решаю.

Структура моей ai-clone/:

ai-clone/
├── INDEX.md           ← карта папки
├── role.md            ← кто я, бэкграунд, что важно
├── identity/          ← ценности, видение, миссия
├── thinking/          ← ментальные модели из эфиров
├── voice/             ← тон, словарь, стиль
├── principles/        ← убеждения - продукт, код, бизнес
├── feedback/          ← правила, выученные через ошибки ← главная папка
├── style/             ← стоп-слова, формат Telegram
└── reference/         ← инструменты, окружение

Самая рабочая папка - feedback/. Туда попадают конкретные правила, которые я выучил через ошибки агента. Каждое правило в отдельном файле по канону:

---
name: краткое-имя
description: одна строка - что в файле и когда применять
type: feedback
---

Краткое правило одним предложением.

**Why:** почему это правило появилось. Контекст, инцидент, наблюдение.

**How to apply:** конкретные триггеры, при которых правило срабатывает.

Без Why правило мёртвое - агент не перенесёт его на похожую ситуацию. Без How to apply правило непонятно когда применять.

Пример из моей папки: правило «дефис, не длинное тире». Возникло, потому что длинное тире — - главный визуальный маркер генеративного текста. Применяется к любому публичному тексту. Файл лежит в ai-clone/feedback/no-em-dashes.md.

Сайт howborisusesclaudecode.com, посвящённый рабочему процессу создателя Claude Code, формулирует это правило так:

Я делаю чуть тоньше: правила пишу не в CLAUDE.md, а в ai-clone/feedback/. Потому что CLAUDE.md - проектный файл, а правила тона и стиля - мои личные. Они едут со мной в следующий проект. CLAUDE.md остаётся с проектом.

Что такое Live Metrics и почему цифры в файлах не хардкодят?

Один из главных провалов начинающего второго мозга - засыпание устаревшими цифрами. Положил «у нас 320 клиентов» - через две недели уже 410. Положил «выручка месяца 4.7 млн» - через месяц цифра без контекста: это план, факт, прогноз?

Я решаю это так. В файле business/products/practicum.md вместо цифры стоит маркер:

## Потоки

> **LIVE** - выполни запросы из `live-metrics.md`, секция «Продажи» 
> чтобы увидеть актуальные оплаты по когортам.

| Поток | Даты | Оплативших |
|-------|------|------------|
| 1 | 10-12 марта 2026 | LIVE |
| 2 | 24-26 марта 2026 | LIVE |

Отдельно лежит файл live-metrics.md. В нём - готовые SQL-запросы и описание, что они возвращают:

## Продажи (оплаты по когортам)

```sql
SELECT c.name, COUNT(p.id) AS paid, SUM(p.amount) AS revenue
FROM purchases p
JOIN cohorts c ON c.id = p.cohort_id
WHERE p.status = 'paid'
GROUP BY c.name
ORDER BY c.starts_at DESC;
```

Когда я задаю агенту вопрос «сколько у нас оплат по второму потоку», агент:

1. Читает business/products/practicum.md
2. Видит маркер LIVE рядом с цифрой
3. Открывает live-metrics.md
4. Находит секцию «Продажи»
5. Выполняет запрос к продовой БД
6. Отвечает на свежих данных

Это решает сразу две проблемы. Цифры не устаревают. И решения принимаются на актуальной картине, а не на прошлогодней.

Как ИИ путешествует по второму мозгу за один запрос?

Пример конкретного запроса: «собери черновик письма участникам про новый поток».

1. Claude стартует с пустого окна. Грузит CLAUDE.md (правила, стек, маршрутизация).
2. По маршрутизации в CLAUDE.md видит: «ai-clone/INDEX.md - читать всегда в начале сессии». Открывает, понимает кто я, какой у меня тон, какие стоп-слова.
3. Видит в маршрутизации: «email-шаблоны - src/lib/email/layout.ts». Открывает, понимает формат.
4. Видит: «контекст про продукт - business/products/practicum.md». Открывает, читает про продукт.
5. Видит в файле маркер LIVE и упоминание live-metrics.md. Открывает, видит готовый SQL. Если ему нужна свежая цифра - выполняет. Если нет - помечает «эту цифру подтянуть на момент отправки».
6. Видит в ai-clone/style/telegram-format.md правила тона. В ai-clone/feedback/no-em-dashes.md - запрет на длинное тире. В business/marketing/funnel.md - конверсии воронки.

Пишет письмо: тон мой, цифры свежие, без длинного тире и ИИ-маркеров.

Anthropic в инженерном блоге называет такой подход just-in-time контекстом:

Перевожу: Claude носит с собой не данные, а указатели на данные. Это в разы экономнее по токенам и в разы точнее, потому что в контексте оказывается только релевантное. Окно остаётся чистым для рассуждения.

5 антипаттернов второго мозга - что не делать?

Антипаттерн 1. Раздутый CLAUDE.md. 500 строк инструкций «вместо того, чтобы класть всё подряд». Anthropic пишет об этом прямо:

Антипаттерн 2. Кладовка. Кидаешь во второй мозг всё подряд: сырую переписку, бесполезные скриншоты, отчёты, в которые никто не зайдёт. Через месяц папка распухает, агент тратит токены на чтение мусора, ты сам не помнишь, где что лежит. Правило: каждый файл во втором мозге должен закрывать конкретный вопрос. Если файл за полгода никто не открывал - удаляй или переноси в архив.

Антипаттерн 3. Дублирование. «Платежи идут через CloudPayments, в файле src/lib/payment/cloudpayments.ts, провайдер настроен в .env». Это всё агент увидит в коде сам. Не дублируй в business/. Дублирование стареет: код поменяли, в business/ забыли обновить, агент работает на устаревшей информации.

Антипаттерн 4. Хардкод цифр. «У нас 1247 клиентов, средний чек 4500 ₽, конверсия 6.3%» - представь, что это цифры из абстрактного финтех-стартапа. Через неделю любые такие цифры устарели. Используй маркер LIVE и live-metrics.md. Раздел про это - выше.

Антипаттерн 5. Бизнес отдельно от кода. Это самая болезненная ошибка. Второй мозг в одной папке, код в другой. Агент в Claude Code запускается в папке с кодом и не видит вторую папку. Чтобы это не происходило - держи business/ и ai-clone/ внутри репозитория проекта, рядом с src/ и prisma/. Тогда агент видит и код, и контекст одновременно, в одном дереве файлов.

Как собрать второй мозг за час - пошаговый рецепт

1. Создай две корневые папки

   В корне проекта рядом с src/:

   bash

   Скопировать

   mkdir -p business/{products,audience,goals,economics,marketing}
   mkdir -p ai-clone/{identity,voice,principles,feedback,style}

2. Сделай INDEX.md как карту папки

   business/INDEX.md - таблица «вопрос → файл». Минимально 5 строк, дальше дополнишь по ходу. То же самое в ai-clone/INDEX.md.

3. Кинь короткие описания продукта и клиента

   business/products/main.md - что за продукт, кому, за сколько, чем отличается. 30-50 строк. business/audience/avatar.md - кто клиент, какие боли, что покупает. 30-50 строк. Не описывай идеал - опиши реальное. Если не знаешь - оставь пометку «уточнить» и иди дальше.

4. Опиши себя в ai-clone/role.md

   Кто ты, чем занимаешься, что для тебя важно. 20-30 строк. Этого достаточно для старта. Тон, принципы, стоп-слова добавишь, когда заметишь, что агент пишет не в твоём стиле.

5. Допиши маршрутизацию в CLAUDE.md

   Открой CLAUDE.md и добавь раздел:

   markdown

   Скопировать

   ## Карта проекта
   
   - Контекст про бизнес → `business/INDEX.md`
   - Контекст про меня → `ai-clone/INDEX.md`
   - Технические планы → `plans/YYYY-MM-DD-*.md`
   - Рефлексии прошлых сессий → `retrospectives/`
   
   Всегда читай `ai-clone/INDEX.md` и `business/INDEX.md` в начале сессии.

6. Запусти Claude Code и проверь

   Открой агент. Спроси: «расскажи мне про мой продукт и про мою аудиторию». Если ответил из контекста папок - всё работает. Если придумал - проверь, что папки лежат рядом с проектом, файлы названы правильно, маршрутизация в CLAUDE.md написана точно.

Дальше второй мозг растёт по двум принципам.

Первый: каждый раз, когда агент ошибается, добавляешь правило. Через 3-4 недели в ai-clone/feedback/ лежит 15-20 файлов с правилами, агент перестаёт делать большинство типовых ошибок.

Второй: каждый раз, когда принимаешь решение по бизнесу, фиксируешь в business/. Подняли цену - запись в business/products/pricing.md с датой и причиной. Поменяли позиционирование - запись в business/company/about.md. Через полгода у тебя архив, который помнит «почему».

Мы с тобой за эту неделю достаточно большой объём работы сделали.

Проанализируй все изменения в коде за неделю, все коммиты, которые мы сделали.
Что ценного из этого должно жить в business/ - выпиши в подходящие файлы
с wiki-ссылками на соседние файлы, чтобы не потерять контекст.

Если в коде есть решения, которые я не объяснил - спроси меня причину
и зафиксируй в подходящем файле с пометкой даты.

Не дублируй то, что и так очевидно из кода. Только то, что без business/
агент в следующей сессии не узнает.

Что дальше - Skills, Subagents и контекст-инжиниринг

Когда второй мозг собран, дальше идут три инструмента, которые Anthropic называет тремя разными уровнями оптимизации контекста.

Skills - это процедурные знания. Если у тебя есть рабочий процесс, который повторяется (написать инструкцию практикума, собрать пост в Telegram, провести аудит сайта), его можно закодировать в SKILL.md файл с описанием задачи. Claude в начале сессии сканирует названия и описания скиллов и подгружает только те, что подходят под текущую задачу. Это экономит токены и держит фокус.

Subagents - изолированные экземпляры Claude с собственным контекстным окном. Запускаешь subagent на тяжёлую задачу (прочитать 30 файлов и собрать саммари), он работает в своём окне, возвращает только результат. Твоё основное окно остаётся чистым. Anthropic пишет:

Контекст-инжиниринг - управление тем, что вообще попадает в окно. Andrej Karpathy и команда Anthropic в 2025 году называют это базовым навыком работы с агентами, уровнем выше prompt engineering. Prompt engineering - подбор формулировок. Контекст-инжиниринг - подбор файлов, маршрутов, скиллов, субагентов.

Второй мозг - первый кирпич контекст-инжиниринга. Без него Skills читают пустоту, Subagents не имеют куда нырнуть, окно агента наполняется случайной информацией. С ним - все три инструмента начинают работать.

Следующий шаг. Заведи две папки рядом с проектом - business/ и ai-clone/. Сделай в каждой INDEX.md на 5 строк как карту. Допиши в CLAUDE.md четыре строки маршрутизации. Через час у тебя готов рабочий каркас второго мозга. Дальше наращиваешь по правилу «после каждой ошибки агента - одна строка в ai-clone/feedback/». Полный шаблон CLAUDE.md, к которому ты будешь маршрутизировать второй мозг, разбираю в гайде Как настроить CLAUDE.md правильно.

Полная схема по вайб-кодингу за вечер: ИИ-клон + Второй мозг + Контекст-инжиниринг. 3 эфира по 2 часа, 2 000 ₽. Записи остаются у тебя.

Практикум по вайб-кодингу

+Твой второй мозг

3 вечера - стек, метод, первый проект

Старт 26–28 мая  ·  2 000 ₽

Записаться →