cookbook-brain

Дайте вашим агентам память, которой вы владеете.

cookbook-brain хранит то, что узнают ваши ИИ-агенты, в виде простых markdown-файлов в git-репозитории на вашем диске. Claude Code, Codex или любой MCP-клиент могут запоминать, вспоминать и опираться на это: один мозг для всех ваших агентов. Ваш Claude и ваш Codex наконец знают одно и то же и даже могут передавать работу друг другу. Каждая заметка указывает, кто её написал — человек или какой агент. Ничто никогда не перезаписывается. И заметки заслуживают доверие единственным способом, который что-то значит: быть правильными, когда от них зависела реальная работа.

Откройте папку в Obsidian, и вы увидите обычные заметки, потому что это всё, что это такое.

Quickstart

npx cookbook-brain init             # creates ./brain with a schema note
npx cookbook-brain harvest          # propose notes distilled from your recent Claude Code sessions
npx cookbook-brain harvest --apply  # write the proposals the refuter kept
claude mcp add brain -- npx cookbook-brain serve

Ваш мозг начинается полным: прежде чем ваша первая сессия агента когда-либо подключится, harvest читает ваши недавние локальные расшифровки Claude Code и извлекает решения, подводные камни и соглашения, уже содержащиеся в них, в заметки с указанием авторства (см. «Harvest» ниже; он только предлагает, пока вы не скажете --apply).

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

Другие команды:

npx cookbook-brain log           # recent notes, newest first
npx cookbook-brain credit <id>   # credit notes whose facts held up in real work
npx cookbook-brain tasks         # open and claimed tasks, with age
npx cookbook-brain doctor        # validate every note, link, chain, and task
npx cookbook-brain index         # generate INDEX.md, a wikilinked view of the brain
npx cookbook-brain web           # read-only local viewer at http://127.0.0.1:4321
npx cookbook-brain install-hook  # every session harvests itself when it closes (report-only)

Каталог мозга определяется флагом --dir, затем переменной окружения BRAIN_DIR, затем ./brain. Атрибуция автора-человека берётся из BRAIN_HUMAN, с запасным вариантом на имя пользователя вашей ОС. Требуется Node 20 или новее.

Related MCP server: clawmem-mcp-server

Why files

Память ваших агентов не должна жить в чужой векторной базе данных. Файлы означают, что вы можете читать каждую память, просматривать каждое изменение, greпить в 2 часа ночи, делать резервное копирование через git и уйти в любое время, сохранив свою папку. Поставщики меняют политики; markdown — нет.

И нет, под капотом нет векторной базы данных по трём конкретным причинам. Эмбеддингам нужен API-ключ и сетевые вызовы, а этот инструмент не делает ни того, ни другого: ничего не покидает ваш диск. Векторный индекс непрозрачен: вы не можете его grep-ить, diff-ить или увидеть, почему он вернул то, что вернул. А в масштабах личного мозга (сотни заметок, а не миллионы документов) простой текстовый поиск плюс граф ссылок работают так же хорошо. Векторы окупают свою сложность на масштабе корпуса. Это не корпус; это мозг.

The format

Одна заметка на файл. Frontmatter содержит факты о факте:

---
id: 01J8ZQ4X2E5N9GVHBK3W7T1MCD
type: decision
title: Poll interval is 30s, not 10
aliases: ["Poll interval is 30s, not 10"]
author:
  human: diego
  agent: claude-code
created: 2026-08-18T17:20:00.000Z
supersedes: null
source: "https://status.example.com/limits"
credits: 3
last_credited: 2026-08-20T09:30:00.000Z
---
Free-tier endpoints rate-limit hard. At 10s we tripped limits on 3 of 8
targets. 30s stays under every limit tested. Related:
[[Unknown check state renders as degraded]]

Заметки типизированы (decision, gotcha, convention, note, open_thread, task) и атрибутированы человеку плюс, если заметку написал агент, метке агента. Необязательное поле source указывает, откуда берётся факт (URL, путь к файлу, идентификатор тикета); цитируемая память — это проверяемая память, и она получает более высокий предел уверенности. Каждая заметка также содержит список aliases со своим собственным заголовком; имена файлов содержат дату и слаг, и этот псевдоним позволяет Obsidian разрешать вики-ссылки [[Title]] в нужный файл (см. «Использование с Obsidian» ниже). Вики-ссылки — это граф. При воспроизведении возвращается заметка ВМЕСТЕ с обратными ссылками и строками вокруг каждого упоминания, так что агенты получают связанный контекст, а не изолированные факты. При воспроизведении также возвращается дословно каждая активная заметка convention независимо от запроса: постоянные правила передаются, чтобы агенты применяли их ко всей работе, а не только к той, которая их искала. Имена файлов имеют формат <дата>--<слаг-заголовка>.md, так что каталог читается как журнал.

Never overwrite

Обновление заметки создаёт новую заметку, которая заменяет старую. Старый файл остаётся, помеченный как superseded. Две причины, обе усвоенные на горьком опыте: каждое переписывание ИИ незаметно теряет немного смысла, и вы не можете отлаживать память без её истории. Журнал git вашего мозга — это его журнал аудита.

Тела заметок только добавляются навсегда; ровно два счётчика могут быть проставлены на месте в существующем файле: credits и last_credited, записываемые, когда работа, опиравшаяся на заметку, подтверждённо завершена. Эта пара кредитов — вторая разрешённая мутация, наряду со штампом superseded_by. Заметки задач содержат третий набор штампов, только на заметках типа task: status, claimed_by, result и abandon_reason. Ничто другое в существующем файле никогда не трогается.

Confidence: trust is earned, not asserted

Каждое воспроизведение содержит оценку уверенности и уровень (proven / standing / verify). Формула публична и намеренно скучна:

score = clamp(cap - 0.10 + 0.05 * min(credits, 3) - staleness, 0.20, cap)

• Происхождение устанавливает потолок. Заметка, написанная человеком, имеет потолок 0,95. Заметка агента, ссылающаяся на источник (поле source в frontmatter, строка source: или URL в теле): 0,85. Утверждение агента без источника: 0,60. Никакое количество повторений не поднимет заметку выше её потолка.

• Кредиты повышают её. Свежая некредитованная заметка находится на 0,10 ниже своего потолка. Когда работа, которая использовала заметку, подтверждённо завершается успешно, «кредитуйте» заметку (один вызов CLI или позвольте вашему агенту сделать это по завершении); каждый кредит добавляет 0,05, а три кредита возвращают потолок.

• Молчание понижает её. Устаревание вычитает 0,05 за каждые полные 90 дней с момента last_credited (или с момента created, если никогда не кредитовалась), до 0,15. Заметка, которую никто не кредитовал месяцами, деградирует к «проверьте перед доверием».

Оценки округляются до двух знаков. Уровни: proven означает, что кредитовано хотя бы один раз И оценка 0,80 или выше, так что только заметки, на которые опиралась реальная завершённая работа, могут быть proven. standing (0,60 или выше) можно использовать с доверием. Всё остальное — verify: проверьте, прежде чем строить на этом.

Это та часть, которую не предлагает ни одна другая система памяти: память, которая отвечает не только «что мы говорили?», но и «было ли это когда-нибудь действительно правильным, когда это имело значение?»

Tasks: your agents can hand each other work

Задача — это просто ещё одна заметка (тип: task) со статусом и исполнителем:

"assign my codex a task: read docs/brief.md and draft the FAQ"

Ваш Claude пишет заметку задачи. В следующий раз, когда ваша сессия Codex запускается и вспоминает мозг, открытая задача, адресованная ему, находится в разделе open_tasks ответа. Он забирает её, выполняет работу и завершает её, и завершение — это то, где цикл замыкается: завершающий агент записывает, на какие заметки он опирался (helped_note_ids), и эти заметки получают кредиты. Вот как память зарабатывает доверие без необходимости выполнять команды учёта.

И когда взятая задача оказывается не по силам агенту (отсутствие доступа, повторные сбои), он отказывается от задачи, а не сидит на ней: задача возвращается в статус open с указанием причины в abandon_reason, видимой для назначившего и следующего претендента. Видимость сбоев — это функция; задача, которая молча гниёт, хуже, чем задача, громко возвращённая. Причина очищается, когда кто-то в следующий раз берёт задачу.

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

Dreaming

Мозги, которые только накапливают, со временем заиливаются. npx cookbook-brain dream — это ежевечерний проход консолидации: он объединяет дубликаты, повышает дважды кредитованные gotcha до соглашений (conventions), помечает противоречия как открытые обсуждения (open threads) и переименовывает конфликтующие заметки, причём каждое предложение проверяется оппонентом-опровергателем (adversarial refuter), прежде чем что-либо применяется. Он работает в вашем собственном Claude CLI под вашим логином: cookbook-brain никогда не хранит API-ключ и не совершает собственных сетевых вызовов.

npx cookbook-brain dream               # report-only: propose and review, apply nothing
npx cookbook-brain dream --apply       # execute the proposals the refuter kept
npx cookbook-brain dream --apply --commit  # then git commit the brain directory (only paths under it)
npx cookbook-brain dream --json        # machine-readable report on stdout (report file still written)
npx cookbook-brain dream --dry-digest  # print exactly what would be sent to the model, then exit
npx cookbook-brain dream --model <id>  # pick the model; default is your claude setting

Как работает dream, по порядку:

1. Проверка гигиены, без модели. Детерминированный проход собирает дублирующиеся активные заголовки, заменённые заметки, на которые всё ещё ссылаются активные вики-ссылки, и устаревшие неподтверждённые заметки (уровень verify, старше 90 дней). Эти находки служат основой для следующего шага.

2. Предлагающий (Proposer). Один вызов claude -p получает компактный обзор ваших активных заметок (идентификатор, тип, заголовок, кредиты, возраст, первые 280 символов каждого тела) и может предлагать операции только из закрытого набора: merge, promote, flag_contradiction, retitle_for_collision. Запустите сначала --dry-digest, если хотите прочитать, что именно отправляется модели; вызов опровергателя дополнительно отправляет полный текст любой заметки, которую затрагивает предложение.

3. Опровергатель (Refuter). Второй вызов claude -p со свежим контекстом и без памяти о предложении проверяет каждое предложение по полному тексту его исходных заметок и должен ответить keep или reject с указанием причины. Предложение, вердикт которого не может быть разобран, по умолчанию отклоняется, никогда не сохраняется молча. Если сам вызов опровергателя завершается неудачей или возвращает мусор, весь dream помечается refuter: absent, и ничего не применяется, даже с --apply. Отчёт всегда различает «нет возражений» и «рецензент так и не появился». Приглашение опровергателя ограничено 24 000 символов: когда предложения вместе с их исходными заметками превысят этот лимит, самые большие предложения исключаются из проверки, записываются как «not reviewed: too large» и никогда не применяются, поскольку непроверенные предложения никогда не применяются.

4. Применить (Apply), только если вы попросили. По умолчанию — только отчёт. С --apply сохранённые предложения выполняются обратимо: объединение создаёт одну новую заметку, в поле consolidates которой перечислены идентификаторы источников, и ставит каждому источнику штамп superseded_by; повышение делает то же самое в соглашение (convention); противоречие создаёт обычную заметку open_thread (пропускается, если активная open_thread уже ссылается на обе заметки, так что один и тот же конфликт никогда не отмечается дважды); переименование — это просто замена. Во время записи apply удерживает файл brain/.lock: инструменты записи MCP ожидают его освобождения, чтение никогда не блокируется, а блокировка старше десяти минут считается устаревшей (аварийное завершение apply) и переопределяется с предупреждением. Отмена dream — это git revert его коммита, потому что dream только добавляет файлы и ставит штампы superseded_by. Добавьте --commit, и успешный apply выполнит коммит каталога мозга за вас, затрагивая только пути внутри него.

Каждый dream записывает отчёт в brain/dreams/DREAM_<date>.md (подкаталог, который сканер заметок никогда не читает): статистика обзора, результаты проверки гигиены, каждое предложение с его обоснованием, каждый вердикт опровергателя с причиной, обязательная строка refuter: ran или refuter: absent, что было применено и как это отменить.

Одно свойство, на которое стоит обратить внимание: заметки, написанные dream, имеют авторство { human: you, agent: "dream" }, и применяется ограничение происхождения для голого агента. Мозг не доверяет собственным снам, пока работа не докажет их. Объединённая dream заметка начинается с низкой уверенности, как и любое другое утверждение агента без источника, и зарабатывает доверие только тем, что оказывается правильной, когда от неё зависит реальная работа.

Nightly, if you want it

Dreams предназначены для запуска, пока вы спите. Простая строка crontab делает это:

15 3 * * * cd /path/to/your/project && npx cookbook-brain dream >> brain/dreams/cron.log 2>&1

Оставьте --apply и читайте отчёты за кофе, или добавьте его, когда доверитесь вкусу вашего опровергателя. В любом случае, сделайте коммит мозга после, чтобы каждый dream был одним откатываемым коммитом; --apply --commit делает этот коммит за вас.

Harvest: your brain starts full

Новый мозг не должен начинаться пустым, когда недели ваших реальных решений лежат в локальных расшифровках сеансов. npx cookbook-brain harvest читает ваши недавние сессии Claude Code, извлекает их в атомарные заметки и пропускает каждое предложение через того же оппонента-опровергателя, который проверяет dreams. Так мозг загружается в первый день и пополняется после насыщенной недели.

npx cookbook-brain harvest                  # report-only: propose notes from the last 7 days
npx cookbook-brain harvest --days 30        # scan further back
npx cookbook-brain harvest --project myapp  # only sessions whose working directory basename matches
npx cookbook-brain harvest --apply          # write the notes the refuter kept
npx cookbook-brain harvest --session <id> --since-last  # one session, only messages newer than its watermark
npx cookbook-brain harvest --dry-digest     # print exactly what would be sent to the model, then exit
npx cookbook-brain harvest --json           # machine-readable report on stdout (report file still written)
npx cookbook-brain harvest --sessions <path> --model <id>   # override the transcripts root and the model

Прямые ответы на вопросы, которые вы должны задавать:

• Что он читает. Локальные транскрипты Claude Code из ~/.claude/projects (переопределяется через --sessions) за последние N дней, и да: он читает СОДЕРЖИМОЕ сообщений — сообщения человека и основные выводы ассистента, потому что извлечение содержания и есть вся задача. Окно применяется по ВРЕМЕННОЙ МЕТКЕ каждого сообщения, так что файл сессии, который вы держите открытым месяцами, отдаёт только свои сообщения в пределах окна, а не всю историю. Трафик инструментов, транскрипты саб-агентов и собственные запуски claude -p инструмента (вызовы harvest и dream, определяемые по маркеру промпта) пропускаются. Это намеренная противоположность инструментам, работающим только с метаданными; здесь это заявлено, чтобы вы никогда не обнаружили это с удивлением.

• Куда он это отправляет. Компактные дайджесты по сессиям отправляются в ваш собственный вошедший в систему claude CLI — тот же инструмент, который изначально создал эти сессии. Никаких ключей API, никаких других сетевых вызовов, ничего не покидает вашу машину по путям, которые не использует ваш логин claude. --dry-digest выводит точный исходящий промпт.

• Что он записывает. По умолчанию — ничего. Отчёт в brain/dreams/HARVEST_<date>.md перечисляет каждое предложение, каждый пропуск дедупликации (факты, которые мозг уже знает) и каждое заключение опровергателя, включая обязательную строку refuter: ran или refuter: absent; непроверенный harvest ничего не применяет, даже с --apply. Только --apply записывает заметки, и применённый harvest только добавляет новые файлы, так что отмена — это git revert или удаление перечисленных файлов.

• Свойство недоверия. Собранные заметки имеют авторство { human: you, agent: "harvest" }, и каждая заметка заканчивается строкой source:, ссылающейся на свою сессию с фактическим диапазоном дат сообщений обработанного фрагмента (например, source: session 2026-08-15, project cookbook-app или source: session 2026-08-12 to 2026-08-18, project phonestack для долгоживущей сессии). Эта цитата даёт агенту с источником ограничение доверия (0.85) через обычное обнаружение источника, без специальных исключений: мозг доверяет своей собственной загрузке больше, чем голому утверждению, но меньше, чем вам, пока реальная работа не повысит доверие к заметкам.

Два флага делают harvest точечным вместо массового. --session <id> обрабатывает ровно один транскрипт (дневное окно всё ещё применяется, по умолчанию щедрые 2 дня в этом режиме). --since-last делает harvest инкрементальным: он читает метки сессий из brain/dreams/harvested.json (сопоставление идентификатора сессии с временной меткой последнего сообщения, обработанного harvest) и обрабатывает только сообщения новее каждой метки, так что файл сессии, который вы держите открытым месяцами, никогда не переваривает старый контент. Каждый успешный harvest, включая режим только отчёта, обновляет метки; неудачный или неразбираемый вызов модели ничего не обновляет, так что контент никогда не теряется молча. Файл находится в dreams/, сканер заметок его не читает, а его удаление означает лишь, что следующий harvest начнётся с обычного дневного окна.

Автосбор: сессии, которые перерабатывают себя

Одна команда заставляет каждую сессию Claude Code собирать себя при закрытии:

npx cookbook-brain install-hook

Это регистрирует хук SessionEnd в ~/.claude/settings.json точечно: файл разбирается, добавляется ровно одна запись, все остальные ключи и хуки сохраняются, и команда отказывается писать, если файл не разбирается. После этого при завершении сессии хук читает полезную нагрузку SessionEnd, запускает ОТДЕЛЬНЫЙ фоновый запуск

cookbook-brain harvest --session <that session> --since-last --json

в рабочем каталоге сессии и немедленно завершается, так что закрытие сессии никогда не задерживается. Метка --since-last означает, что долгоживущая сессия обрабатывается только инкрементально: каждое закрытие перерабатывает только то, что произошло с момента последнего сбора.

Прямые ответы, ещё раз:

• Всегда только отчёт. Хук не может применять, по замыслу и жёстко закодировано: автоматическая запись в вашу память требует вашего предварительного просмотра. Сохранённые предложения накапливаются в отчётах, и cookbook-brain log заканчивается строкой вроде 2 harvest report(s) with unapplied keeps: review with cookbook-brain harvest --apply, когда в недавних отчётах есть сохранённые, но не применённые заметки. Просматривайте их за кофе и применяйте, когда согласны; дедупликация не даёт уже известным фактам попасть дважды.

• Где живёт вывод. Каждый запуск добавляет свой JSON-отчёт в ~/.cookbook-brain-autoharvest.log, а markdown-отчёт попадает в brain/dreams/HARVEST_<date>.md, как и любой другой harvest (веб-просмотрщик тоже их показывает). Каталог мозга определяется из рабочего каталога сессии (./brain или BRAIN_DIR), так что сессия в проекте без мозга просто логирует вежливую ошибку и ничего не меняет.

• Честная заметка о стоимости. Закрытие сессии запускает до двух вызовов модели (предлагатель и опровергатель) через ваш собственный логин claude CLI. Они выполняются в фоне, так что закрытие мгновенно, но это реальные вызовы на вашем аккаунте. Смягчения структурны: сессия без нового контента после метки завершается до любого вызова модели, а собственные запуски claude -p инструмента (вызовы harvest и dream) определяются по маркеру промпта и пропускаются полностью, так что автосбор никогда не рекурсирует на себя.

• Отмена — одна команда. npx cookbook-brain uninstall-hook удаляет только запись cookbook-brain и оставляет все остальные настройки и хуки нетронутыми. Уже запущенные сессии заметят это при следующем перезапуске, в обоих направлениях.

Чем это не является

• Не векторная база данных (см. «Почему файлы» выше; опциональные эмбеддинги могут появиться позже и никогда не будут обязательными).

• Не хостинг. Один мозг, один владелец, любое количество ВАШИХ агентов.

• Не чат-лог. Он хранит атомарные, обдуманные заметки, а не транскрипты; даже harvest, который читает ваши сессии, перерабатывает их в однофактовые заметки и никогда не хранит транскрипт.

Может ли моя команда делить мозг?

Вы можете делиться репозиторием так же, как любым репозиторием, и для двух осторожных людей это наполовину работает. Что ломается — это то, что делает общую память заслуживающей доверия: нет живой синхронизации (вы вспоминаете устаревшие заметки, пока кто-то не сделает pull), конкурентные записи означают конфликты слияния, и ничто не обеспечивает атрибуцию: любой может редактировать любой файл, включая его кредиты. Запись, которую кто угодно может молча переписать, — это не запись.

Принудительная атрибуция, живая синхронизация, атомарные утверждения задач и квитанции, которые кредитуют память всей команды, требуют сервера, который нельзя обойти. Это продукт, который мы продаём: cookbook.team — это многопользовательский мозг. Этот репозиторий — однопользовательский, и он честно отличен в этой работе.

cookbook-brain и Obsidian

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

Так что же добавляет этот инструмент сверх того, что не даёт хранилище Obsidian плюс один из существующих MCP-серверов для хранилищ? Те серверы открывают дверь: агент может читать, редактировать и удалять ваши заметки. Этот инструмент добавляет дисциплину для того, что через неё проходит. Серверы хранилищ позволяют агенту перезаписать вашу заметку; здесь каждое изменение — это новая атрибутированная заметка, заменяющая старую. Заметки в хранилище одинаково доверяются навсегда; здесь заметки имеют происхождение и зарабатывают доверие через результаты. А хранилище понятия не имеет, какой из ваших агентов что написал или как они передают работу; здесь это и есть вся суть.

Obsidian — это где вы читаете свой мозг. cookbook-brain — это то, что не даёт вашим агентам его разрушить.

Использование с Obsidian

Открыть как хранилище

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

Почему ссылки разрешаются: псевдонимы

Имена файлов содержат дату и слаг (2026-08-18--poll-interval-is-30s.md), но тела заметок ссылаются по заголовку ([[Poll interval is 30s]]). Мостом служит поле aliases в frontmatter: каждая заметка содержит свой собственный заголовок как псевдоним, и Obsidian разрешает вики-ссылки через псевдонимы. Заметки, написанные cookbook-brain 0.5 и ранее, не имеют этого поля; cookbook-brain doctor предупреждает о них, а

npx cookbook-brain doctor --fix-aliases

добавляет aliases: [<title>] в каждую активную заметку, где его не хватает. Это дополнение является разрешённым изменением frontmatter, задокументированным в SCHEMA.md вместе с метками supersede и credit, и оно никогда не трогает тело.

Просмотр свойств

Obsidian читает frontmatter как свойства: откройте любую заметку, и вы увидите type, author, created, credits, last_credited, а для задач — status, assigned_to, claimed_by, result. Это делает поиск Obsidian и панель свойств бесплатной поверхностью запросов по метаданным мозга.

Мозг внутри вашего хранилища

Уже есть хранилище? Поместите мозг в подпапку и укажите инструментам путь:

npx cookbook-brain init --dir ~/Vault/brain
claude mcp add brain -- npx cookbook-brain serve --dir ~/Vault/brain

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

Ручное редактирование

Ваши файлы, редактируйте свободно; дисциплина «только добавление» связывает инструменты агентов, а не ваши руки. Исправьте опечатку, перефразируйте тело, удалите заметку, которая вам никогда не была нужна: это ваш мозг. Правило «никогда не перезаписывать» существует, чтобы ни один ИИ не переписывал историю молча, а не чтобы не пускать вас. После массового ручного редактирования cookbook-brain doctor сообщит, если что-то сломало ссылку, цепочку supersede или задачу.

Фрагменты Dataview

Требуют плагин сообщества Dataview. Отрегулируйте FROM "brain", если ваша папка мозга называется иначе.

Все решения с кредитами (ближайший прокси для уровня «доказано» только через frontmatter; точный расчёт уровня требует формулы доверия, которую показывает web):

```dataview
TABLE credits, last_credited, author.agent AS agent
FROM "brain"
WHERE type = "decision" AND credits >= 1 AND !superseded_by
SORT credits DESC
```

Ловушки, никогда не получившие кредитов (зафиксированные, но ещё не подтверждённые реальной работой):

```dataview
TABLE created, author.agent AS agent
FROM "brain"
WHERE type = "gotcha" AND credits = 0 AND !superseded_by
SORT created ASC
```

Открытые задачи по исполнителю:

```dataview
TABLE assigned_to, abandon_reason, created
FROM "brain"
WHERE type = "task" AND status = "open" AND !superseded_by
SORT assigned_to ASC
```

Домашняя страница и просмотр уровней

npx cookbook-brain index генерирует INDEX.md в корне мозга: каждая активная заметка как вики-ссылка, сгруппированная по типу, сначала соглашения, каждая с уровнем и кредитами. Это хорошая домашняя страница хранилища; это представление, а не заметка, так что повторная генерация перезаписывает его, а сканер игнорирует его. А для того единственного, что Obsidian не показывает — живых расчётов доверия и уровней — запустите npx cookbook-brain web: просмотрщик только для чтения на http://127.0.0.1:4321 с индикаторами доверия, значками уровней, доской задач и отчётами о сборах и снах.

Когда ваша команда готова

Ваш мозг и cookbook.team говорят на одном языке: те же типы заметок, те же уровни, та же дисциплина источников, те же глаголы задач. Так что миграция — это одна инструкция агенту, подключённому к обоим: прочитай каждую активную заметку в моём мозге и запомни её в моё рабочее пространство команды, с тем же типом, заголовком, телом и источником. Атрибуция переносится. Ваши соглашения начинают использоваться в каждом воспоминании каждого товарища по команде, как только они попадают туда.

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

Сохраните мозг после обновления. Многие захотят и то, и другое: мозг для личного контекста, рабочее пространство для командного контекста. Это разные высоты, а не конкуренты.

Благодарности и честная карта

Mem0, Zep и Letta — отличные хостируемые/инфраструктурные слои памяти с возможностями, которых нет у этого инструмента (управляемый масштаб, временные графы, корпоративные функции). QM поставляет ограниченную по объёму персональную память для команд. cookbook-brain отличается по трём осям: ваша память — это файлы, которыми вы владеете, а не строки в сервисе; каждая заметка атрибутирована и доступна только для добавления; доверие зарабатывается на результатах, а не утверждается в момент записи. Если вам нужен управляемый API памяти — используйте их. Если вам нужен мозг, который можно читать — используйте это.

Зачем мы это создали

В cookbook.team мы создаем многопользовательскую версию: общее рабочее пространство, где люди и агенты команды работают на одной доске, делят один разум, и каждая задача формирует квитанцию, которая приписывает использованную память. cookbook-brain — это тот слой памяти, однопользовательский, бесплатный, ваш. Если ваша команда когда-нибудь захочет общую версию, вы знаете, где кухня.

MIT, авторское право Diego Prozzi.