Три папки и один CLAUDE.md

Второй мозг звучит масштабно, а на деле это несколько текстовых файлов в паре папок и один файл-карта, который объясняет агенту, что где лежит. Никакого Obsidian, никакой базы данных, никакого приложения — только markdown на диске. В этом гайде соберём такой скелет с нуля: разложим папки, напишем файл-карту (это и есть CLAUDE.md), заведём правила именования и разберём, как агент всё это читает. К концу у тебя будет структура, которую можно скопировать и начать наполнять сегодня же.

Короткий ответ

Второй мозг — это плоские .md-файлы в нескольких простых папках плюс один CLAUDE.md в корне, который работает индексом: он говорит агенту, где какая информация, как называются файлы и как их читать. Правило одно на всё: один файл = одна тема, а CLAUDE.md — карта, по которой агент находит нужное. Приложение для заметок не нужно вообще.

Что понадобится

• Агент, который читает файлы в папке проекта, — Claude Code или Codex. Больше ничего не требуется.
• Любой текстовый редактор. Файлы обычные .md, открываются чем угодно.
• Пять минут, чтобы создать папки. Наполнять их будешь потом, по ходу дела — не нужно писать всё сразу.

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

Принцип: плоские файлы, а не приложение

Соблазн сразу поставить Obsidian или завести базу в Notion — и это первая же ошибка. Приложению нужен его формат, его хранилище, его интерфейс, и агент через всё это продирается с трудом. Простой текстовый файл на диске агент читает напрямую, без прослоек.

Поэтому база второго мозга — плоские markdown-файлы. «Плоские» значит: обычный текст с простой разметкой (заголовки, списки), без вложенных баз, без связей, которые понимает только конкретное приложение. Открывается где угодно, читается кем угодно — и человеком, и агентом. Это не компромисс ради простоты, это и есть сила: чем проще формат, тем меньше между твоими знаниями и агентом лишних стенок.

Скелет: несколько папок под смысл

Раскладка простая — папки по типу того, что в них лежит. Базовый скелет выглядит так:

second-brain/
  CLAUDE.md          <- карта: что где лежит (главный файл)
  notes/             <- факты и заметки
    claude-code.md
    nastrojka-vps.md
    nalogi.md
  people/            <- люди и компании, по карточке на каждого
    ivan-petrov.md
    studia-oformlenie.md
  projects/          <- проекты и их состояние
    blog.md
  MEMORY.md          <- долгая память: ключевые факты
  LEARNINGS.md       <- уроки и выводы
  decisions.md       <- лог решений: что решил и почему

Разберём логику. Три смысловые папки закрывают почти всё:

• notes/ — факты и заметки по темам. Разобрался в чём-то, записал вывод — сюда. Один файл на тему.
• people/ — карточки на людей и компании: кто это, о чём договаривались, что важно помнить. По файлу на каждого.
• projects/ — состояние проектов: что делаешь, на чём остановился, что дальше.

Плюс несколько отдельных файлов в корне, которые не про тему, а про тебя и ход дел: MEMORY.md — долгая память (ключевые факты, которые не должны потеряться), LEARNINGS.md — уроки, decisions.md — лог решений с причинами. Не нужно повторять эту раскладку буква в букву — это отправная точка. Убери лишнее, добавь свою папку (например, под учёбу или клиентов), но держи её плоской и осмысленной.

CLAUDE.md — это карта

Вот сердце всей затеи. Папки сами по себе — просто папки; чтобы агент знал, что в них искать и по каким правилам, ему нужна карта. Карта — это файл CLAUDE.md в корне. Он не хранит знания, он объясняет устройство: где что лежит, как называются файлы, как их читать. Индекс и свод правил в одном месте.

Почему именно CLAUDE.md: Claude Code подхватывает этот файл в контекст автоматически при старте — тебе не нужно каждый раз просить «прочитай карту». Агент видит её сам ещё до первого твоего вопроса и уже знает планировку своего мозга. Вот как может выглядеть такой файл:

# Второй мозг — карта

Это моя база знаний в текстовых файлах.
Отвечай мне из этих файлов, не выдумывай.

## Где что лежит
- notes/       — факты и заметки. Одна тема = один файл.
- people/      — карточки людей и компаний.
- projects/    — состояние проектов: где остановился, что дальше.
- MEMORY.md    — долгая память, ключевые факты обо мне и делах.
- LEARNINGS.md — уроки и выводы, чтобы не наступать дважды.
- decisions.md — лог решений: что решил и почему.

## Правила
- Один файл = одна тема.
- Имя файла = тема в нижнем регистре через дефис (claude-code.md).
- Отвечай ТОЛЬКО из этих файлов. Нашёл — назови файл, откуда взял.
- Не нашёл — скажи «не нашёл», не сочиняй.
- Новый факт кладётся в подходящий файл, дубли не плодим.

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

Карта — самый важный файл во всём мозге. Заметок может быть сто, и агент справится, если карта ясная. А без карты даже десять файлов превращаются в свалку, где он гадает, где что лежит. Вкладывайся в CLAUDE.md в первую очередь.

Ещё один приём: @-подключение ядра

В боевых сборках карту часто усиливают так: CLAUDE.md не просто описывает файлы словами, а прямо подтягивает несколько самых важных через @ — ссылку на путь. Пишешь в карте строку вида @MEMORY.md, и содержимое этого файла грузится в контекст вместе с картой, автоматически:

# Второй мозг — карта
...
@USER.md
@MEMORY.md
@decisions.md

Смысл в чём: карта и ядро (кто ты, долгая память, ключевые решения) оказываются перед агентом сразу, без отдельной просьбы прочитать. Остальное — папки notes/, people/ — он читает уже под конкретный вопрос. Не тащи в @-подключения всё подряд: туда идёт только то, что должно быть перед глазами всегда, иначе раздуешь контекст. Пара-тройка ключевых файлов — нормально.

Правила именования: один файл = одна тема

Это выглядит мелочью, но именно на именах базы разваливаются. Дисциплина простая:

• Один файл — одна тема. Не сваливай десять разных вещей в один zametki.md. Тема «настройка VPS» — файл nastrojka-vps.md. Тема «налоги» — nalogi.md. Так агент открывает ровно то, что нужно, а не читает простыню, чтобы выудить одну строку.
• Имя = тема. Файл называется так, чтобы по имени было ясно, что внутри. ivan-petrov.md, а не zametka-3.md. Агент выбирает файл в том числе по имени — понятное имя ускоряет поиск.
• Один стиль на все имена. Нижний регистр, слова через дефис. Не смешивай МоиЗаметки.md и moi_zametki.md — единообразие помогает и тебе, и агенту.

Правило «одна тема — один файл» — не эстетика, а прямая экономия. Мелкий файл под тему агент читает быстро и точно; гигантский файл-свалку он вынужден прогонять целиком, тратя контекст и рискуя промахнуться.

Как агент это читает

Собранное работает так. При старте Claude Code сам загружает CLAUDE.md из корня — карта уже в контексте, планировка агенту известна. Ты задаёшь вопрос обычными словами. Агент по карте понимает, в какой папке или файле искать, открывает нужное и отвечает — со ссылкой на файл, откуда взял. Не нашёл — говорит «не нашёл», как ему и предписано правилами в карте.

Тебе не нужно каждый раз указывать путь или просить «прочитай вот этот файл». В этом и вся идея: ты общаешься на человеческом языке, а навигацией по файлам занимается агент, потому что карта дала ему схему. Твоя работа — держать структуру чистой и наполнять её; работа агента — доставать.

Частые ошибки

FAQ

Обязательно называть файл-карту именно CLAUDE.md?

Если работаешь в Claude Code — да, потому что этот файл он подхватывает в контекст сам, автоматически. Смысл карты — быть перед глазами агента без отдельной просьбы, а CLAUDE.md даёт это из коробки. С другим агентом принцип тот же (карта в корне), но проверь, какой файл он читает по умолчанию.

Сколько папок заводить?

Начни с трёх (notes, people, projects) плюс пара файлов в корне. Этого хватает надолго. Новую папку добавляй, когда реально появилась отдельная область, — не заводи пустые «на будущее».

Нужно ли сразу всё заполнить?

Нет. Скелет создаётся за пять минут, а наполняется по ходу дела: разобрался в чём-то — записал, договорился с человеком — завёл карточку. База растёт вместе с работой, а не пишется одним подходом.

А если файлов станет очень много?

Пока держишь правило «одна тема = один файл» и ясную карту — много файлов не проблема, агент находит нужный по карте и имени. Проблема начинается не от количества, а от свалки: огромные файлы без структуры и без карты.

Итог

Второй мозг собирается из трёх вещей: плоские .md-файлы, дисциплина «одна тема — один файл» и CLAUDE.md-карта, которая говорит агенту, где что лежит и как это читать. Никакого Obsidian и никакой базы — только текст на диске, который агент читает напрямую. Вложись в карту в первую очередь: заметки прощают многое, кривая или отсутствующая карта — нет.

Дальше стоит понять, как агент сам дописывает эту память и учится на ходу — об этом гайд Как агент помнит и учится сам.