second-brain-starter

Рабочая заготовка «второго мозга» на обычных markdown-файлах, который поддерживает ИИ-агент. Не курс, не методология и не приложение — папка с правилами, шаблонами и ритуалами, которую можно забрать целиком и править под себя.

Собрана из практики: две базы знаний, которые я веду больше полугода — рабочую и личную.

Разворачивание одной фразой

Откройте агента (Claude Code или аналог, умеющий работать с файлами) и скажите:

Разверни мне базу знаний по https://github.com/skive/second-brain-starter

Дальше он сделает всё сам: прочитает BOOTSTRAP.md, спросит только одно — в какой папке разворачивать, — разложит базу, включит историю изменений и сразу проведёт онбординг: задаст шесть вопросов о вас и вашей области и заполнит ими правила.

Что это и чем отличается от «просто заметок»

Заметки умирают не от нехватки функций, а от стоимости содержания: раскладывать, связывать, чистить и вспоминать о существовании заметок приходится вручную. Агент забирает именно эту работу, и содержание базы становится посильным для одного человека.

Заготовка стоит на трёх опорах:

1. Хранилище — обычные текстовые файлы. Их читают человек, поиск, программа и языковая модель. Нет экспорта, нет привязки к поставщику, есть история в git.
2. Правила в корне. Файл CLAUDE.md (или AGENTS.md — как назовёт ваш агент) агент читает первым. Там написано, кто вы, как устроены папки, что можно и что нельзя.
3. Ритуалы. Приём входящего и обязательный недельный проход. Без прохода база превращается в свалку примерно за месяц.

Что нужно

• Любой редактор markdown. Obsidian удобен графом и быстрым поиском, но он — вид на папку, а не хозяин данных; заменяется без миграции.
• Агент, работающий с файлами на диске: Claude Code, Codex CLI или аналог. Веб-чат не подходит принципиально — ему нужен доступ к папке, а не вложения.
• git для истории изменений. Необязательно, но восстанавливает нервы после того, как агент однажды перепишет не тот файл.

Структура

vault/                   ← это и станет вашей базой
  CLAUDE.md              правила базы — агент читает первым
  index.md               оглавление по разделам
  00_Система/            служебный контур: лента, вопросы, решения, журнал сессий
  Inbox/                 сырьё без редактуры: ссылки, выгрузки, черновики
  10-<Домен>/            доменные папки заводит онбординг по вашим ответам
  90-Шаблоны/            формы заметок
  95-Ритуалы/            приём входящего, еженедельный проход
  Archive/YYYY-MM/       разобранные оригиналы
  .claude/skills/        скилл онбординга

BOOTSTRAP.md             инструкция агенту по разворачиванию
scripts/                 вспомогательные скрипты разворачивания

Нумерация с шагом 10 нужна, чтобы вставлять разделы между существующими, не переименовывая папки. Доменные папки заводите под свои области — у меня это компания, стратегия, ландшафт систем, исполнение, операции.

Скилл онбординга

vault/.claude/skills/second-brain-onboarding/SKILL.md — сценарий первичной настройки для агента: интервью пачками по два-три вопроса, заполнение правил ответами владельца, создание доменных папок, ленты и оглавления, первый разбор входящего.

Работает сразу после клонирования, если агент читает скиллы из .claude/skills (Claude Code — да). Главное правило внутри: ничего не выдумывать за владельца, на что не ответили — то остаётся открытым вопросом, а не правдоподобной выдумкой.

Что пошло не так у меня (чтобы вы этого не повторяли)

• Один общий журнал изменений врёт. Когда файл становится длиннее, чем агент готов перечитывать перед записью, новые записи начинают противоречить старым. Лечится не инструментом, а формой: одна карточка на одно изменение вместо летописи, агент правит карточку, а не дописывает журнал. См. vault/90-Шаблоны/Карточка-изменения.md.
• Агент пишет «проверено», не проверив. Поле «чем проверено» обязательно, и его надо выборочно перепроверять руками.
• Правила устаревают молча. Раз в месяц перечитывайте CLAUDE.md целиком: половина проблем с агентом — это не ошибки модели, а ваши старые инструкции.
• Не тащите в базу то, что меняется каждую неделю. Статусы задач живут в трекере, база знаний — для того, что живёт месяцами.

Системный контур

00_Система/ — память базы о самой себе. Три журнала обязательны, четвёртый заводится по потребности:

• Лента — захват мыслей одной строкой сверху, разбирается на недельном проходе.
• Открытые вопросы (Q-N) — вопрос без ответа обязан иметь следующее действие и владельца, иначе это не вопрос, а тревога.
• Журнал решений (D-N) — единственное место, где хранится довод. Что сделано, видно по результату; почему выбрали этот вариант, не видно нигде. Записи задним числом не правятся: передумали — новое решение со ссылкой «пересматривает D-N».
• Журнал сессий — три-пять строк о каждой сессии. Нужен не вам, а агенту: прочитав последние записи, он понимает контекст без пересказа. Ротация помесячная, иначе файл дорастает до размера, при котором агент перестаёт его перечитывать, и записи начинают противоречить друг другу.
• Календарь обязательств — по потребности: продления, дедлайны, регуляторные даты.

Больше журналов заводить не стоит. Каждый из них требует дисциплины, и лишний превращается в мёртвый файл, который создаёт ложное чувство порядка.

Что не класть в базу

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

Источники идеи

• Andrej Karpathy, «The append-and-review note» — одна текстовая нота, новое сверху, старое тонет; отсюда vault/00_Система/Лента.md.
• Andrej Karpathy, «LLM Wiki», 4 апреля 2026 — три слоя (неизменяемые источники, вики, файл-схема) и мысль о том, что знание надо компилировать в структуру, а не выводить заново на каждый вопрос.
• Tiago Forte, «Building a Second Brain» — сам термин и метод PARA.

Отличие этой заготовки от llm-wiki. У Карпаты вики целиком принадлежит модели, человек её почти не пишет. Здесь иначе: страницы, где формулируется позиция и принимаются решения, пишет человек, потому что формулировка — это и есть мышление. Агенту достаётся раскладка, связывание, поиск, сводки и бухгалтерия ссылок.