Второй мозг для Claude Code: как собрать структуру за час

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

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

---
name: краткое-имя
description: одна строка о содержании файла и условиях применения
type: feedback
---

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

**Why:** причина появления правила: контекст, случай или наблюдение.

**How to apply:** конкретные условия, при которых правило следует использовать.

## Потоки

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

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

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

```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. Ответить по свежему результату.

Такой подход помогает не опираться на устаревшие показатели и принимать решения с учётом актуальных данных.

<div class="aside" data-semantic="callout" role="note" aria-label="Внимание">

Внимание

Доступ к производственной базе следует выдавать только доверенным агентам и через обёртку, которая журналирует запросы и скрывает пароли. Не храните открытый пароль для `psql` в `live-metrics.md`. Обёртка может получать пароль из переменной окружения и не показывать его в выводе. Без этих мер доступ к актуальным метрикам создаёт риск утечки.

</div>

## Как Claude находит нужные сведения во втором мозге?

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Главное в разделе">

Коротко

Маршрут поиска можно выстроить так: Claude читает `CLAUDE.md`, открывает указанные в нём карты `business/INDEX.md` и `profile/INDEX.md`, выбирает нужный раздел и переходит к конкретному документу. Если нужно актуальное число, агент обращается к источнику LIVE. Вместо загрузки всей папки он выполняет несколько целевых операций чтения, сохраняя контекстное окно для рассуждений.

</div>

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

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

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

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

<figure>
<blockquote>
Агенты, работающие по принципу just-in-time, хранят лёгкие указатели — например, пути к файлам, сохранённые запросы и ссылки — и с помощью инструментов динамически добавляют содержимое в контекст во время выполнения.
</blockquote>
<figcaption>— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents</figcaption>
</figure>

Иными словами, Claude может хранить рядом указатели на данные и открывать только нужное. Это сокращает объём нерелевантного содержимого в контекстном окне и оставляет больше места для анализа.

## Пять ошибок при создании второго мозга

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Главное в разделе">

Коротко

Пять частых ошибок: слишком длинный `CLAUDE.md` вместо краткого маршрутизатора; папка, куда складывают всё подряд; дублирование сведений, которые уже есть в коде; неизменяемые показатели без LIVE; недоступный агенту контекст или отсутствие маршрута к нему независимо от хранения в общем репозитории или отдельном приватном хранилище.

</div>

**Ошибка 1. Слишком большой `CLAUDE.md`.** Вместо кратких правил в файл добавляют сотни строк. Anthropic рекомендует проверять каждую запись:

<figure>
<blockquote>
Старайтесь писать кратко. Для каждой строки спросите себя: «Начнёт ли Claude ошибаться, если удалить её?» Если нет, уберите её. Избыточные файлы `CLAUDE.md` могут помешать Claude следовать действительно важным указаниям.
</blockquote>
<figcaption>— Anthropic, code.claude.com/docs/en/best-practices</figcaption>
</figure>

В качестве ориентира можно оставить 80–120 строк, а остальные сведения вынести в отдельные файлы и добавить к ним маршруты.

**Ошибка 2. Папка-кладовка.** Во второй мозг добавляют необработанные переписки, ненужные изображения и отчёты, к которым никто не обращается. В результате папка разрастается, а агент тратит токены на материалы, не относящиеся к задаче. Для каждого файла стоит определить конкретный вопрос, на который он отвечает. Если документ долго не открывают, его можно удалить или переместить в архив.

**Ошибка 3. Повторение сведений из кода.** Например, можно записать, какой провайдер обслуживает платежи и в каком файле настроен. Если это уже однозначно видно в исходниках и конфигурации, запись в `business/` будет дублировать код. Когда реализация изменится, такое описание может устареть.

**Ошибка 4. Необновляемые показатели.** Значения вроде числа клиентов или конверсии быстро меняются. Вместо них используйте LIVE и инструкции в `live-metrics.md`.

**Ошибка 5. Контекст без доступного маршрута.** Если второй мозг в другом месте, а у агента нет ни разрешения, ни указателя, запуска из папки кода недостаточно. Нечувствительные общие заметки удобно хранить в `business/` и `profile/` рядом с кодом. Для приватного контекста выберите отдельно управляемое место и явно настройте разрешённый доступ и маршрутизацию. Удобство папок не отменяет конфиденциальность.

<div class="aside" data-semantic="callout" role="note" aria-label="Совет">

Совет

Отдельная ветка `context` или `business-context` организует работу, но не создаёт границу доступа: файлы остаются объектами Git в том же репозитории и могут публиковаться с ветками или историей. Для приватных бизнес-данных используйте отдельный закрытый репозиторий или внешнее хранилище с явными правами и разрешённым маршрутом агента. Приватность submodule определяется правами отдельного репозитория, а не механизмом submodule. Другой вариант — намеренно игнорируемая локальная папка с отдельной резервной копией. Игнорирование не удаляет уже отслеживаемые файлы и опубликованную историю. С кодом храните только разрешённый для совместного доступа контекст.

</div>

## Как собрать второй мозг за час: пошаговая настройка

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Главное в разделе">

Коротко

Для минимальной системы создайте рядом с проектом каталоги `business/` и `profile/`, добавьте в каждый `INDEX.md` с картой содержимого, подготовьте краткие описания продукта и аудитории, а сведения о себе запишите в `profile/role.md`. Затем добавьте маршруты в `CLAUDE.md`. Позже пополняйте `profile/feedback/` правилами после ошибок агента, а в `business/` сохраняйте важные решения.

</div>

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

    Разместите их рядом с `src/`:

    ```bash
    mkdir -p business/{products,audience,goals,economics,marketing}
    mkdir -p profile/{identity,voice,principles,feedback,style}
    ```

2. #### Подготовьте INDEX.md — карту папки

    В `business/INDEX.md` создайте таблицу «вопрос → файл». Начните хотя бы с пяти строк и расширяйте её по мере появления материалов. Аналогичную карту добавьте в `profile/INDEX.md`.

3. #### Кратко опишите продукт и аудиторию

    В `business/products/main.md` укажите, что это за продукт, для кого он предназначен, сколько стоит и чем отличается. Ориентир — 30–50 строк. В `business/audience/avatar.md` опишите клиента, его потребности и то, что он покупает, также примерно в 30–50 строк. Описывайте реальную ситуацию, а неизвестные сведения помечайте как требующие уточнения.

4. #### Опишите себя в profile/role.md

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

5. #### Добавьте маршруты в CLAUDE.md

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

    ```markdown
    ## Карта проекта

    - Контекст о бизнесе → `business/INDEX.md`
    - Контекст обо мне → `profile/INDEX.md`
    - Технические планы → `plans/YYYY-MM-DD-*.md`
    - Итоги прежних сессий → `retrospectives/`

    Всегда читай `profile/INDEX.md` и `business/INDEX.md` в начале сессии.
    ```

6. #### Откройте Claude Code и проверьте результат

    Попросите агента рассказать о продукте и целевой аудитории. Если ответ опирается на содержимое файлов, маршруты работают. Если Claude додумывает сведения, проверьте расположение папок, имена файлов и точность правил в `CLAUDE.md`.

Далее второй мозг можно развивать по двум направлениям.

Во-первых, после повторяющейся ошибки агента добавляйте подходящее правило. За три-четыре недели в `profile/feedback/` может накопиться 15–20 файлов, которые помогут избежать части типовых ошибок.

Во-вторых, фиксируйте важные бизнес-решения. Например, изменение цены можно описать в `business/products/pricing.md`, добавив дату и причину, а новое позиционирование — в `business/company/about.md`. Со временем получится архив не только решений, но и объяснений к ним.

<div class="section" data-semantic="prompt" aria-label="Промпт">

**Промпт: вечернее обновление второго мозга**

```
За эту неделю мы выполнили большой объём работы.

Проанализируй изменения в коде и все сделанные коммиты.
Определи, какие полезные сведения следует сохранить в business/, и внеси
их в подходящие файлы, добавив wiki-ссылки на связанные материалы.

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

Не повторяй то, что уже понятно из кода. Добавляй только то, что агент
не сможет узнать в следующей сессии без материалов из business/.
```

</div>

## Что изучить дальше: Skills, Subagents и управление контекстом

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Главное в разделе">

Коротко

`CLAUDE.md` и второй мозг образуют основу. Сверху можно добавить Skills для процедурных знаний, Subagents для отдельных сложных задач и методы управления тем, что попадает в контекстное окно. Каждый инструмент помогает по-своему; сначала агенту нужна упорядоченная база материалов, откуда можно брать сведения.

</div>

После настройки второго мозга можно использовать инструменты, которые Anthropic описывает как разные способы работы с контекстом.

**Skills** — это описания повторяемых процедур. Например, можно зафиксировать порядок подготовки учебной инструкции, публикации в Telegram или аудита сайта в файле `SKILL.md`. В начале сессии Claude просматривает названия и описания skills, а затем загружает подходящие к текущей задаче. Такой подход помогает не держать все инструкции постоянно в контексте.

**Subagents** — отдельные экземпляры Claude с собственными контекстными окнами. Им можно поручить объёмную задачу, например изучить 30 файлов и составить сводку. Subagent выполнит работу отдельно и вернёт результат, не перегружая основное окно. Anthropic описывает этот подход так:

<figure>
<blockquote>
Специализированные субагенты могут решать отдельные задачи в чистых контекстных окнах. Каждый из них способен изучить большой объём материалов, расходуя десятки тысяч токенов или больше, и вернуть только сжатый итог работы — часто на 1 000–2 000 токенов.
</blockquote>
<figcaption>— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents</figcaption>
</figure>

**Управление контекстом** — это выбор сведений, которые попадут в окно агента. В официальных материалах Anthropic такой подход описывается как важная часть работы с агентами. Он включает организацию файлов, маршрутов, skills и subagents, чтобы Claude получал подходящую информацию для текущей задачи.

Второй мозг может стать основой такого устройства. Он даёт агенту упорядоченные материалы, к которым можно обращаться из skills и subagents, и помогает избегать случайного наполнения контекстного окна.

**Следующий шаг.** Создайте рядом с проектом папки `business/` и `profile/`. Добавьте в каждую `INDEX.md` примерно на пять строк и внесите маршруты в `CLAUDE.md`. Так появится исходный каркас второго мозга. После ошибок агента добавляйте правила в `profile/feedback/`. Подробный шаблон `CLAUDE.md` для настройки маршрутов разобран в руководстве [Как правильно настроить CLAUDE.md](guide-126.md).

<div class="section" role="doc-bibliography" aria-label="Источники">

### Источники

- [Документация Claude Code: Memory](https://code.claude.com/docs/en/memory) — официальное описание памяти Claude Code от Anthropic.
- [Claude Code: Best practices](https://code.claude.com/docs/en/best-practices) — официальные рекомендации по использованию `CLAUDE.md`.
- [Effective context engineering for AI agents](https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents) — материал Anthropic о контекстном окне, его ограничениях и загрузке данных по мере необходимости.
- [Skills explained](https://claude.com/blog/skills-explained) — материал Anthropic о Skills и их связи с Memory, Subagents и MCP.

</div>

Продолжить знакомство с Ailoot можно на [ailoot.ai](https://ailoot.ai/).