Vault

Как разложен мой vault, чтобы агент мог в нём жить. Шаблоны и рекомендованные плагины.

Папки верхнего уровня beaver-agent

Эмодзи в именах - мои, структура - не догма. Что важно для агента: дневник по дням, люди карточками с aliases и chat_id, доски Kanban с Tasks-запросами (для агента это текст, читает файл до строки ***), проекты папками, мысли с датой в имени, чаты по месяцам.

Полная таблица с правилами - в грануле карта-vault.md. Мокап справа - тот же vault, что и на главной, плюс зона агента.

Зона агента beaver-agent

мета/бобер/ - единственное место, где агент может удалять. Всё остальное в мета/ (шаблоны QuickAdd и Templater, таблицы) - зона пользователя, твоя: хук отобьёт.

Личные файлы показаны в мокапе шаблонами: профиль.md, поправки.md, наблюдения/, реплики/, выжимки/, дни/, индекс.md, состояние.md, куратор.md, роадмап.md. Форма настоящая, содержимое - нет: это и есть память, и она личная.

Роадмап beaver-agent

мета/бобер/роадмап.md - главный файл: # Сфера → ## [[проект]] → ### этап, ### цель на <месяц> внутри проекта. Строки без даты - намерения, с датой - обязательства; отменённое помечается датой и причиной, не стирается. Агент пишет туда по просьбе и когда Бобёр чётко зафиксировал решение, и всегда оставляет строку в дневнике.

Дневник beaver-agent

📅 дни/YYYY-MM-DD.md: ## сводка, лента HH:MM - текст между двумя ---, в конце # планы с tasks-запросами. Агент пишет туда только по просьбе, первым лицом, его языком, без пометок об авторстве. Сегодняшний дневник едет в конверт добавленными строками.

Настройка Obsidian вокруг

Что поставить и зачем:

Obsidian Sync - им vault приезжает на сервер (модуль «Деплой»). Другая синхронизация тоже сработает, если умеет в headless-контейнер, но официальный клиент проще.
Tasks - задачи строками - [ ] с датами и запросы по ним; агент читает их как текст.
Kanban - доски по сферам, файл на сферу, архив ниже ***.
beaver-calendar - календарь и список задач поверх Tasks и Kanban, единственный удобный для человека способ с ними работать. Ставится из релиза: make install VAULT=…, потом включить в Community plugins.
Templater и QuickAdd - шаблоны из мета/шаблоны/ (человек, мысль, ресерч, событие, чат, вещи, медиа; заметка, дневник). В Templater включи Folder templates, чтобы каждая заметка рождалась с полем тегов.
Calendar - на папку дней; Dataview - запросы в досках и карточках; Omnisearch - поиск для человека, агент ищет grep-ом.

Полный список моих плагинов и биндов - в README мока справа.

Плагин Beaver вокруг

Без него глубоких чатов из Obsidian нет. Gateway за файлами не следит: markdown-фронтенд - это POST /md/chat, и реплику из файла отправляет команда плагина Send using selected agent, а ответ стримится обратно в буфер. Чат, открытый из мастера, появляется файлом сам (ChatMirror), и продолжить его можно той же командой.

Вторая половина - панель: те же разговоры, дерево тул-коллов, действия админки. Таб с рельсом разговоров или узкая колонка в правом сайддоке; Open chat in panel открывает разговор текущего файла по conversation_id из фронтматтера.

Установка: make install VAULT=~/Obsidian/vault из репозитория кладёт четыре файла в .obsidian/plugins/beaver; дальше включить Beaver в Community plugins. На телефон файлы приезжают через Obsidian Sync с включённым «Installed community plugins».

Настройки:

Base URL - корень markdown-фронтенда, https://host/md
API origin - где живёт /api; пусто = выводится из Base URL
Bearer token - токен из админки (Система → токены): scope messages для отправки, api для панели
Chats folder - папка в этом vault, где лежат глубокие чаты: та, в которую пишет markdown-фронтенд gateway (у меня это 💬 чаты)