# Второй мозг для Claude Code: как собрать структуру за час > Как организовать второй мозг для Claude Code: уровни памяти, пять папок и Git, чтобы агент сохранял контекст проекта между сессиями. Source: https://ailoot.ai/blog/ru/claude-code-second-brain/ Canonical: https://ailoot.ai/blog/ru/claude-code-second-brain/ Language: ru Publisher: Ailoot (https://ailoot.ai/) Translation: guide-233 Revision: sha256-047654b511717fb98a3ede77795a674be032cc0588052c0538db6079be729b3b
Коротко Второй мозг для Claude Code — это не отдельный файл, а пять папок и Git. В `CLAUDE.md` задаются правила и маршруты, в `business/` собираются сведения о проекте, в `profile/` — информация о вас как о человеке, который принимает решения, в `plans/` — технические планы, а в `retrospectives/` — выводы из предыдущих сессий. Claude начинает с `CLAUDE.md` и по указанным ссылкам открывает материалы, подходящие к текущей задаче. Ниже разобраны уровни памяти из официальной документации Claude Code, пример структуры и последовательность настройки примерно за час.
Справочные материалы Ailoot доступны на [ailoot.ai/docs/](https://ailoot.ai/docs/). ## Зачем Claude Code нужен второй мозг и что в нём должно быть?
Коротко `CLAUDE.md` задаёт основные правила, но не хранит весь контекст бизнеса. Со временем можно забыть, зачем меняли цену или отказались от рассрочки. Важные сведения часто разбросаны по памяти, перепискам в Telegram, документам Google и знаниям сотрудников. Второй мозг собирает их в папке с Markdown-файлами рядом с проектом, откуда Claude может самостоятельно брать нужный контекст.
Во вторник вы запускаете Claude Code и рассказываете ему о проекте, аудитории и ограничениях. В четверг открываете новый чат и повторяете объяснение с начала. Если уже есть `CLAUDE.md`, часть повторяющихся объяснений можно убрать. Основные правила и сведения о проекте хранятся в одном файле и доступны в каждой сессии. Устройство такого файла рассматривается в [руководстве по CLAUDE.md](https://ailoot.ai/blog/ru/kak-nastroit-claude-md/); его можно прочитать заранее, чтобы подготовить основу. `CLAUDE.md` похож на памятку новому сотруднику: что надевать, каким тоном обращаться к клиентам, какими командами публиковать материалы. Но одной инструкции недостаточно для удачных решений по проекту. Для них нужны сведения о продукте, аудитории, экономике, прошлых экспериментах и их результатах. Такие знания нередко находятся в четырёх местах: в вашей памяти, переписках в Telegram, документах Google и опыте сотрудников. Через месяц причины принятого решения могут забыться, а новому человеку придётся расспрашивать коллег, чтобы войти в курс дела. Claude без отдельной структуры не получает доступа к этому контексту. Без `business/` при каждой сессии приходится заново объяснять агенту, кто клиент, как устроено предложение и через какого провайдера проходят платежи. Если же папка есть, можно попросить Claude обновить предложение для нового тарифа. Агент прочитает требования в `business/company/legal.md`, затем проверит новый тариф в `business/products/pricing.md` и подготовит изменение с учётом обоих файлов. Повторный разогрев не нужен: контекст подгружается по ссылкам.
Заметка Дело не в плохой памяти Claude, а в устройстве его работы. Контекстное окно служит оперативной памятью агента: в него попадает то, на что вы указали, а остальная информация остаётся за его пределами и загружается при необходимости. Второй мозг хранит эти сведения в упорядоченном виде, чтобы Claude мог найти нужное.
В инженерном материале Anthropic эту проблему называют ухудшением работы с контекстом по мере его наполнения:
Чем больше токенов находится в контекстном окне, тем труднее модели точно извлекать из него нужную информацию.
— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents
Иными словами, избыток информации в окне мешает агенту работать с деталями. Можно хранить контекст во внешних файлах и направлять Claude к конкретным материалам по мере надобности. Это и есть практическая основа второго мозга. ## Что означает «второй мозг» и как применить эту идею в Claude Code?
Коротко Идея второго мозга проста: освободить память человека для размышлений, а накопленные сведения хранить снаружи. В работе с Claude Code это превращается из приёма для продуктивности в устройство агентной системы: заметки лежат в доступной через файловую систему папке, откуда агент может их читать.
Обычно второй мозг используют для общих задач продуктивности: например, создают хранилище Obsidian и добавляют туда цитаты из книг, записи встреч и замыслы проектов. При применении этой идеи к Claude Code на первый план выходит архитектура агента. В обычном подходе человек сам ищет заметки. Здесь к ним обращается и Claude, поэтому формат файлов имеет значение. Файлы должны читаться без дополнительной интеграции. Для этого подходит Markdown: в нём есть текст, иерархия заголовков и ссылки между документами. Notion и Google Docs можно подключить через MCP, но это добавляет ещё один слой, расход токенов и дополнительную точку отказа. Если файлы находятся рядом с проектом, в его файловой системе, Claude Code может их видеть. Для этого не требуется отдельная настройка: запущенный в папке проекта агент получает доступ к её содержимому.
Совет Для просмотра связей можно открыть эти же файлы в Obsidian. При этом физически они остаются обычными Markdown-документами в папке рядом с кодом. Obsidian служит удобным интерфейсом, а Claude может читать файлы и без него. Подойдёт любой редактор, если материалы хранятся на диске, а не в формате закрытого облачного сервиса.
## Какие уровни памяти Claude Code поддерживает изначально?
Коротко Claude Code умеет читать четыре уровня `CLAUDE.md`: корпоративный, пользовательский, проектный и локальный. Начиная с версии 2.1.59 он также поддерживает автоматическую память в `~/.claude/projects//memory/`. Этих возможностей достаточно для базовых инструкций, но бизнес-контекст обычно нужно хранить отдельно, в папке рядом с проектом.
Сначала полезно разобраться в штатных механизмах памяти. В [официальной документации Anthropic](https://code.claude.com/docs/en/memory) описаны `CLAUDE.md`, в который пользователь записывает правила, и автоматическая память, куда Claude самостоятельно сохраняет выводы. Содержимое обоих механизмов учитывается при начале сессии. Claude Code может искать `CLAUDE.md` на четырёх уровнях: | Уровень | Расположение | Назначение | |----|----|----| | **Корпоративный** | `/Library/Application Support/ClaudeCode/CLAUDE.md` (macOS), `/etc/claude-code/CLAUDE.md` (Linux), `C:\Program Files\ClaudeCode\CLAUDE.md` (Windows) | Общие правила, которые администратор распространяет на команду через MDM. Для индивидуального использования этот уровень обычно не нужен. | | **Пользовательский** | `~/.claude/CLAUDE.md` | Личные правила для всех проектов, например предпочитаемый язык ответа или просьба не ставить длинное тире. | | **Проектный** | `./CLAUDE.md` в корне проекта | Инструкции для конкретного проекта: используемые технологии, дерево папок и бизнес-правила. Такой файл можно включить в Git. | | **Локальный** | `./CLAUDE.local.md` | Личные заметки о проекте, которые не следует добавлять в Git. Файл указывают в `.gitignore`. | Все четыре уровня участвуют в формировании контекста. Более конкретные настройки имеют больший приоритет. Локальный файл читается последним и поэтому может переопределить остальные правила. В подпапках проекта тоже можно размещать отдельные `CLAUDE.md`. Claude подгружает их по мере работы с файлами внутри соответствующей папки. Это удобно для монорепозитория: инструкции для фронтенда могут лежать в `frontend/CLAUDE.md`, а для бэкенда — в `backend/CLAUDE.md` и подключаться по необходимости. Автоматическая память появилась в Claude Code версии 2.1.59. Это набор файлов, в которых Claude сохраняет полезные сведения: ``` ~/.claude/projects//memory/ ├── MEMORY.md # Индекс, загружаемый в каждую сессию (200 строк или 25KB) ├── debugging.md # Подробные заметки, загружаемые по требованию ├── api-conventions.md └── ... ``` В документации Anthropic принцип работы описан так:
Claude не сохраняет сведения после каждой сессии автоматически. Он сам оценивает, что может пригодиться в будущих разговорах.
— Anthropic, code.claude.com/docs/en/memory
Автоматическую память включает параметр `autoMemoryEnabled` в `~/.claude/settings.json`. Claude сам выбирает, что туда записать. Файл `MEMORY.md` можно просматривать и редактировать вручную: это обычный Markdown.
Внимание Автоматическая память полезна, но не заменяет второй мозг. Claude может сохранить технические наблюдения об инструментах и коде: например, что скрипту нужен определённый флаг или как называется таблица базы данных. Стратегический контекст бизнеса туда не попадает сам собой. Если агенту нужно учитывать аудиторию и причины выбора цены, эти сведения стоит записать отдельно.
## Где проходит граница между CLAUDE.md и вторым мозгом?
Коротко `CLAUDE.md` задаёт поведение агента и команды, которыми он должен пользоваться. Второй мозг описывает, чем занимается проект, для кого он работает, какова его экономика и какие решения уже принимались. Первый файл служит указателем, а второй — архивом знаний: без указателя агент может не найти архив, без архива ему будет не хватать контекста бизнеса.
Представьте, что вы наняли нового сотрудника. Что вы расскажете ему в первый день? Вы дадите короткую инструкцию: как одеваться, когда приходить, каким тоном отвечать клиентам и в какой системе публиковать материалы. Такая памятка объяснит правила поведения, но не расскажет, что именно делает компания и почему. Для этого нужен отдельный справочник. В нём могут быть описания продукта, целевой аудитории, цен и причин их выбора, рынка, конкурентов и прошлых ошибок. Его не нужно изучать целиком: сотрудники открывают нужный раздел под конкретный вопрос. Получается простое разделение: `CLAUDE.md` — инструкция, второй мозг — база знаний. Нужны оба. В `CLAUDE.md` записывают то, что **применимо к каждой задаче**: - Роль агента в проекте: помощник, ведущий или ассистент. - Язык ответов. - Стек инструментов. - Команды публикации. - Ограничения, например не ставить длинное тире и не запускать `git push --force`. - Маршруты к сведениям о бизнесе и личным принципам. Во второй мозг помещают материалы, которые **нужны по ситуации**: - Сведения о продукте, аудитории, экономике и целях. - Данные о рынке и конкурентах. - Историю решений и причины их принятия. - Примеры отзывов и обратной связи клиентов. - Принципы и методологию. Anthropic даёт сходную рекомендацию в официальной документации:
`CLAUDE.md` загружается при каждой сессии, поэтому в нём стоит оставлять только широко применимые сведения. Для знаний о предметной области и процессов, нужных лишь иногда, можно использовать skills: Claude подгружает их по необходимости, не увеличивая каждое общение.
— Anthropic, code.claude.com/docs/en/best-practices
Skills помогают хранить знания для отдельных задач. Другой вариант — папка `business/` рядом с проектом. Эти способы можно сочетать. ## Из каких пяти частей состоит мозг проекта и зачем ему Git?
Коротко В основу мозга проекта входят пять папок и Git. `CLAUDE.md` задаёт правила и направления поиска. `profile/` хранит ваши принципы и стиль, `business/` — сведения о проекте, `plans/` — технические планы по этапам, а `retrospectives/` — выводы после работы. Git сохраняет историю изменений, поэтому позднее можно восстановить, что именно было записано во время принятия решения.
Ниже приведён один из вариантов организации папок: | Папка | Содержимое | Для чего нужна | |----|----|----| | **`CLAUDE.md`** | Правила проекта, стек, дерево файлов, ссылки на папки, язык общения | Инструкция для агента, доступная в каждой сессии. Желательно уложить её примерно в 80–120 строк, не превышая ориентир в 200. | | **`profile/`** | Принципы, тон, стиль принятия решений и правила, появившиеся после ошибок | Профиль человека, принимающего решения: что он обычно отклоняет, как формулирует предложения и какие выводы сделал. | | **`business/`** | Продукт, аудитория, цели, экономика, маркетинг, решения и примеры | Связанные Markdown-материалы со ссылками вида `[[...]]`. Агент открывает нужные документы в ответ на конкретный запрос. | | **`plans/`** | Отдельный файл `YYYY-MM-DD-feature.md` для каждой функции, с этапами и чек-боксами | План в Plan Mode может остаться только в текущем диалоге и исчезнуть после `/clear`. Файлы в `plans/` сохраняются в репозитории и доступны другим агентам. | | **`retrospectives/`** | Итоги сессий: сделанное, полезные выводы и возможности улучшения | Материалы для последующего обучения системы. Ошибки можно превращать в правила в `profile/feedback/`. | | **`+ git`** | История версий всех файлов | Позволяет просматривать изменения: с помощью `git log` можно выяснить, когда и почему менялся документ. | Важно **разделять `profile/` и `business/`**. `business/` отвечает на вопрос «что мы делаем»: здесь описываются продукт, аудитория, цены и конкуренты. Эта папка принадлежит проекту и может передаваться вместе с ним. `profile/` отвечает на вопрос «как я принимаю решения»: здесь хранятся принципы, тон, опыт и стоп-слова. Эти сведения относятся к человеку и могут использоваться в разных проектах. ## Что хранить в business/ и чего туда не добавлять?
Коротко В `business/` стоит складывать факты о проекте, которые меняются не чаще раза в неделю: позиционирование, аудиторию, продукты, цены, квартальные цели и важные решения. Не помещайте туда необработанные переписки, сведения, которые уже очевидны из кода, скриншоты и часто меняющиеся цифры. Для динамических показателей используйте маркер LIVE и отдельную инструкцию с SQL-запросами.
Пример верхнего уровня папки `business/`: ``` business/ ├── INDEX.md ← карта папки, читать первой ├── company/ ← миссия, юридические сведения, ценности и регламенты ├── products/ ← продукты, программы и цены ├── audience/ ← портрет клиента, сегменты и возражения ├── goals/ ← цели и показатели на год, квартал и месяц ├── economics/ ← юнит-экономика, доходы, расходы и прогнозы ├── marketing/ ← каналы, воронка, материалы и конкуренты ├── execution/ ← недельное планирование и бэклог └── assets/ ← дизайн-система, отзывы и библиотека текстов ``` Это пример, а не обязательный стандарт. Добавляйте папки по мере надобности. Можно начать с `products/`, `audience/` и `goals/`, а остальные создать позже, когда появятся материалы для них. Главный документ этой папки — `INDEX.md`. В нём размещается таблица «вопрос → файл», которая помогает Claude выбирать, куда перейти. Без такой карты агенту может потребоваться прочитать всё подряд. Например, фрагмент `INDEX.md` может выглядеть так: ```markdown ### Где что искать | Что нужно | Куда смотреть | |---|---| | Кто наш клиент и что его беспокоит | `business/audience/avatar.md` | | Продукты, тарифы и цены | `business/products/` | | Цели и показатели | `business/goals/` | | Доходы, расходы и юнит-экономика | `business/economics/` | | Каналы продвижения и материалы | `business/marketing/` | ``` Тогда в `CLAUDE.md` достаточно указать: «Если вопрос касается бизнеса, открой `business/INDEX.md` и следуй его карте». Агент сначала читает указатель, затем выбирает подходящий документ и не загружает в контекст всю папку. **Что не следует хранить в `business/`:** - Необработанные переписки. Если в них есть полезная мысль, сформулируйте её отдельно; если нет — не сохраняйте. - Информацию, уже содержащуюся в коде. Не дублируйте описание реализации, которое агент может прочитать в исходниках. - Скриншоты и изображения. Они увеличивают объём папки, а текстовая модель не извлекает из них текст без отдельного шага. - Часто меняющиеся показатели. Запись вроде «сегодня было 423 оплаты» быстро устареет. Используйте маркер LIVE и указывайте, где получить актуальные данные. - Конфиденциальные или сомнительные сведения. Учитывайте, что репозиторий могут увидеть сотрудники, агенты и внешние подрядчики. Храните там только то, что допустимо раскрыть в рамках настроенного доступа.
Внимание Если репозиторий открыт, содержимое `business/` тоже может оказаться доступным публике. Разумно обращаться с материалами так, будто проект однажды станет публичным, даже если сейчас он закрыт. Не записывайте имена клиентов без согласия, помесячную выручку и пароли.
## Зачем отделять profile/ от business/?
Коротко В `profile/` хранятся принципы, стиль, стоп-слова и правила, появившиеся после ошибок агента. Каждое правило можно оформить по схеме «правило → почему → как применять» и сохранить в `profile/feedback/`. Профиль можно переносить между проектами, а `business/` относится к конкретному проекту. В новом проекте изменятся бизнес-сведения, но ваши принципы и предпочтения останутся прежними.
Разделение можно выразить коротко: бизнес описывает, чем занимается проект, а профиль — как вы принимаете решения. Пример структуры `profile/`: ``` profile/ ├── INDEX.md ← карта папки ├── role.md ← роль, опыт и важные сведения о человеке ├── identity/ ← ценности, видение и миссия ├── thinking/ ← модели мышления и рабочие наблюдения ├── voice/ ← тон, словарь и стиль ├── principles/ ← убеждения о продукте, коде и бизнесе ├── feedback/ ← правила, выведенные из ошибок ├── style/ ← стоп-слова и формат публикаций └── reference/ ← инструменты и рабочая среда ``` Особенно полезна папка `feedback/`. В неё можно записывать конкретные правила, которые помогают не повторять ошибки агента. Для каждого правила создавайте отдельный файл по такому образцу: ```markdown --- name: краткое-имя description: одна строка о содержании файла и условиях применения type: feedback --- Краткое правило одним предложением. **Why:** причина появления правила: контекст, случай или наблюдение. **How to apply:** конкретные условия, при которых правило следует использовать. ``` Без раздела `Why` агенту сложнее применить правило к похожей ситуации. Без `How to apply` непонятно, когда оно должно срабатывать. Например, можно добавить правило «дефис вместо длинного тире». Основанием может быть желание избегать характерной для генеративных текстов пунктуации. Правило можно распространить на любые тексты для публикации и сохранить в `profile/feedback/no-em-dashes.md`. Правила о личном тоне и стиле удобно держать в `profile/feedback/`, а не в `CLAUDE.md`: они могут использоваться в разных проектах. `CLAUDE.md` при этом остаётся частью конкретного проекта.
Заметка Один из способов оценить пользу такой системы — считать, сколько раз за неделю приходится исправлять одну и ту же ошибку агента. Если после каждого случая добавлять применимое правило в `feedback/`, повторений со временем может стать меньше.
## Что такое Live Metrics и почему меняющиеся цифры не стоит фиксировать в файлах?
Коротко Показатели в документах могут устареть за несколько дней: число клиентов или выручка постоянно меняются. Если сохранить число без обновления, спустя месяц агент будет принимать решения по старым данным. Один из вариантов — поставить в тексте маркер LIVE, а актуальные SQL-запросы описать в отдельном `live-metrics.md`. Увидев маркер, агент может получить свежий показатель из базы, если ему предоставлен безопасный доступ.
Распространённая проблема — сохранять меняющиеся числа как неизменные факты. Например, количество клиентов через две недели уже может быть другим. А сумма вроде «выручка месяца — 4,7 млн» без пояснения не сообщает, идёт ли речь о плане, факте или прогнозе. Вместо числа в `business/products/practicum.md` можно поставить указатель на актуальные данные: ```markdown ## Потоки > **LIVE** — выполни запросы из `live-metrics.md`, раздел «Продажи», > чтобы получить актуальные данные об оплатах по когортам. | Поток | Даты | Оплативших | |-------|------|------------| | 1 | 10-12 марта 2026 | LIVE | | 2 | 24-26 марта 2026 | LIVE | ``` Запросы и пояснения к результатам можно хранить в `live-metrics.md`: ````markdown ## Продажи (оплаты по когортам) ```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. Ответить по свежему результату. Такой подход помогает не опираться на устаревшие показатели и принимать решения с учётом актуальных данных.
Внимание Доступ к производственной базе следует выдавать только доверенным агентам и через обёртку, которая журналирует запросы и скрывает пароли. Не храните открытый пароль для `psql` в `live-metrics.md`. Обёртка может получать пароль из переменной окружения и не показывать его в выводе. Без этих мер доступ к актуальным метрикам создаёт риск утечки.
## Как Claude находит нужные сведения во втором мозге?
Коротко Маршрут поиска можно выстроить так: Claude читает `CLAUDE.md`, открывает указанные в нём карты `business/INDEX.md` и `profile/INDEX.md`, выбирает нужный раздел и переходит к конкретному документу. Если нужно актуальное число, агент обращается к источнику LIVE. Вместо загрузки всей папки он выполняет несколько целевых операций чтения, сохраняя контекстное окно для рассуждений.
Представим запрос: «Подготовь черновик письма участникам о новом потоке». 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:
Агенты, работающие по принципу just-in-time, хранят лёгкие указатели — например, пути к файлам, сохранённые запросы и ссылки — и с помощью инструментов динамически добавляют содержимое в контекст во время выполнения.
— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents
Иными словами, Claude может хранить рядом указатели на данные и открывать только нужное. Это сокращает объём нерелевантного содержимого в контекстном окне и оставляет больше места для анализа. ## Пять ошибок при создании второго мозга
Коротко Пять частых ошибок: слишком длинный `CLAUDE.md` вместо краткого маршрутизатора; папка, куда складывают всё подряд; дублирование сведений, которые уже есть в коде; неизменяемые показатели без LIVE; недоступный агенту контекст или отсутствие маршрута к нему независимо от хранения в общем репозитории или отдельном приватном хранилище.
**Ошибка 1. Слишком большой `CLAUDE.md`.** Вместо кратких правил в файл добавляют сотни строк. Anthropic рекомендует проверять каждую запись:
Старайтесь писать кратко. Для каждой строки спросите себя: «Начнёт ли Claude ошибаться, если удалить её?» Если нет, уберите её. Избыточные файлы `CLAUDE.md` могут помешать Claude следовать действительно важным указаниям.
— Anthropic, code.claude.com/docs/en/best-practices
В качестве ориентира можно оставить 80–120 строк, а остальные сведения вынести в отдельные файлы и добавить к ним маршруты. **Ошибка 2. Папка-кладовка.** Во второй мозг добавляют необработанные переписки, ненужные изображения и отчёты, к которым никто не обращается. В результате папка разрастается, а агент тратит токены на материалы, не относящиеся к задаче. Для каждого файла стоит определить конкретный вопрос, на который он отвечает. Если документ долго не открывают, его можно удалить или переместить в архив. **Ошибка 3. Повторение сведений из кода.** Например, можно записать, какой провайдер обслуживает платежи и в каком файле настроен. Если это уже однозначно видно в исходниках и конфигурации, запись в `business/` будет дублировать код. Когда реализация изменится, такое описание может устареть. **Ошибка 4. Необновляемые показатели.** Значения вроде числа клиентов или конверсии быстро меняются. Вместо них используйте LIVE и инструкции в `live-metrics.md`. **Ошибка 5. Контекст без доступного маршрута.** Если второй мозг в другом месте, а у агента нет ни разрешения, ни указателя, запуска из папки кода недостаточно. Нечувствительные общие заметки удобно хранить в `business/` и `profile/` рядом с кодом. Для приватного контекста выберите отдельно управляемое место и явно настройте разрешённый доступ и маршрутизацию. Удобство папок не отменяет конфиденциальность.
Совет Отдельная ветка `context` или `business-context` организует работу, но не создаёт границу доступа: файлы остаются объектами Git в том же репозитории и могут публиковаться с ветками или историей. Для приватных бизнес-данных используйте отдельный закрытый репозиторий или внешнее хранилище с явными правами и разрешённым маршрутом агента. Приватность submodule определяется правами отдельного репозитория, а не механизмом submodule. Другой вариант — намеренно игнорируемая локальная папка с отдельной резервной копией. Игнорирование не удаляет уже отслеживаемые файлы и опубликованную историю. С кодом храните только разрешённый для совместного доступа контекст.
## Как собрать второй мозг за час: пошаговая настройка
Коротко Для минимальной системы создайте рядом с проектом каталоги `business/` и `profile/`, добавьте в каждый `INDEX.md` с картой содержимого, подготовьте краткие описания продукта и аудитории, а сведения о себе запишите в `profile/role.md`. Затем добавьте маршруты в `CLAUDE.md`. Позже пополняйте `profile/feedback/` правилами после ошибок агента, а в `business/` сохраняйте важные решения.
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`. Со временем получится архив не только решений, но и объяснений к ним.
**Промпт: вечернее обновление второго мозга** ``` За эту неделю мы выполнили большой объём работы. Проанализируй изменения в коде и все сделанные коммиты. Определи, какие полезные сведения следует сохранить в business/, и внеси их в подходящие файлы, добавив wiki-ссылки на связанные материалы. Если в коде видны решения, причины которых я не объяснил, задай мне вопрос и после ответа зафиксируй причину в подходящем файле с датой. Не повторяй то, что уже понятно из кода. Добавляй только то, что агент не сможет узнать в следующей сессии без материалов из business/. ```
## Что изучить дальше: Skills, Subagents и управление контекстом
Коротко `CLAUDE.md` и второй мозг образуют основу. Сверху можно добавить Skills для процедурных знаний, Subagents для отдельных сложных задач и методы управления тем, что попадает в контекстное окно. Каждый инструмент помогает по-своему; сначала агенту нужна упорядоченная база материалов, откуда можно брать сведения.
После настройки второго мозга можно использовать инструменты, которые Anthropic описывает как разные способы работы с контекстом. **Skills** — это описания повторяемых процедур. Например, можно зафиксировать порядок подготовки учебной инструкции, публикации в Telegram или аудита сайта в файле `SKILL.md`. В начале сессии Claude просматривает названия и описания skills, а затем загружает подходящие к текущей задаче. Такой подход помогает не держать все инструкции постоянно в контексте. **Subagents** — отдельные экземпляры Claude с собственными контекстными окнами. Им можно поручить объёмную задачу, например изучить 30 файлов и составить сводку. Subagent выполнит работу отдельно и вернёт результат, не перегружая основное окно. Anthropic описывает этот подход так:
Специализированные субагенты могут решать отдельные задачи в чистых контекстных окнах. Каждый из них способен изучить большой объём материалов, расходуя десятки тысяч токенов или больше, и вернуть только сжатый итог работы — часто на 1 000–2 000 токенов.
— Anthropic, anthropic.com/engineering/effective-context-engineering-for-ai-agents
**Управление контекстом** — это выбор сведений, которые попадут в окно агента. В официальных материалах Anthropic такой подход описывается как важная часть работы с агентами. Он включает организацию файлов, маршрутов, skills и subagents, чтобы Claude получал подходящую информацию для текущей задачи. Второй мозг может стать основой такого устройства. Он даёт агенту упорядоченные материалы, к которым можно обращаться из skills и subagents, и помогает избегать случайного наполнения контекстного окна. **Следующий шаг.** Создайте рядом с проектом папки `business/` и `profile/`. Добавьте в каждую `INDEX.md` примерно на пять строк и внесите маршруты в `CLAUDE.md`. Так появится исходный каркас второго мозга. После ошибок агента добавляйте правила в `profile/feedback/`. Подробный шаблон `CLAUDE.md` для настройки маршрутов разобран в руководстве [Как правильно настроить CLAUDE.md](guide-126.md).
### Источники - [Документация 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.
Продолжить знакомство с Ailoot можно на [ailoot.ai](https://ailoot.ai/). ```` ## Вопросы и ответы ### Сохранит ли другая ветка Git приватность бизнес-контекста? Нет. Это часть того же репозитория, файлы могут передаваться с его объектами и историей. Нужны отдельно управляемое приватное хранилище либо намеренно игнорируемая локальная папка с резервной копией. Игнорирование не стирает прежнюю отслеживаемую историю. ### Как агент найдёт приватный контекст вне репозитория кода? Дайте явный указатель и только необходимые задаче права. Сохраните краткий индекс с маршрутом к нужному документу и проверьте чтение разрешённого файла. Приватное расположение без маршрута не передаёт контекст автоматически. ## Ailoot · Компания и портфель её проектов Ailoot опирается на накопленный опыт работы, большую клиентскую базу, стабильный сервис и постоянный контроль KPI. Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно. Этот опыт Ailoot использует для API-доступа к нейросетям в продуктах клиентов, агентах, приложениях и автоматизациях.