Документация Armarium

Что это

Armarium — агент-хранитель над личной базой заметок. Он ведёт тематическую разведку по вашему списку источников, отвечает строго из ваших заметок с датами и ссылками и восстанавливает, как менялась ваша позиция по теме.

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

Репозиторий распространяется под лицензией MIT: свободно использовать, изменять и распространять.

Требования

• Claude Code — установлен, выполнен вход. Проверка: claude --version.
• git — по истории заметок агент видит, что вы сохранили, и строит траекторию взглядов. Проверка: git --version.
• Заметки в Markdown — обычные файлы .md, например хранилище Obsidian. Структура папок любая.

Уметь программировать не нужно: работа сводится к командам в терминале и правке текстовых файлов.

Установка и первый запуск

6 шагов, выполняются один раз.

1. Заберите репозиторий. Клонируйте его — вместе с историей git, на которую опирается агент.

git clone https://github.com/KirKruglov/ARMARIUM.git
cd ARMARIUM

Если скачали архивом — распакуйте его, откройте папку в терминале и заведите историю сами:

git init
git add -A && git commit -m "chore: initial armarium checkout"

2. Положите заметки в папку knowledge-base/. Раскладка любая — так, как вы их уже держите. Чем плотнее заметки по теме, тем полезнее работа агента по ней; тема без заметок даст пустой дайджест, и это ожидаемый исход.

3. Зафиксируйте базу в git. Сравнение состояний между запусками — тот самый сигнал «что я счёл важным».

git add -A
git commit -m "notes: initial knowledge base"

4. Заполните профиль в global-context/global-context.md: кто вы, какие темы отслеживаете и что считаете шумом. По нему агент судит, релевантна ли находка именно вам.

5. Задайте источники в .claude/armarium/sources.md: уберите ненужные, добавьте свои — ленты, блоги, сайты, на любом языке. Доступность ленты проверяется одной командой:

curl -sI https://importai.substack.com/feed

6. Первый запуск. Сравнивать пока не с чем, поэтому дайджест собирается без сигнала вкуса — вкус агент начинает учить со второго запуска.

claude --agent armarium -p "сделай дайджест"

Единственная точка входа — агент armarium. Одноразовый запрос идёт через -p, режимы с подтверждениями требуют интерактивной сессии: claude --agent armarium.

Как устроен

armarium — агент верхнего уровня. Он разбирает запрос обычными словами, выбирает режим и раздаёт работу профильным субагентам; каждый субагент видит только свою часть задачи и свои права на запись.

• scout — разведка. Обходит ваш список источников по отслеживаемым темам и приносит кандидатов для дайджеста.
• recall — ответы из базы. Ищет по индексу и содержимому заметок, возвращает выдержки с датами и путями к файлам. В базу не пишет.
• chronicle — эволюция взглядов. Сопоставляет заметки с историей git и восстанавливает траекторию A→B→C. Только чтение.
• auditor — здоровье базы. Находит дубли, противоречия, устаревшее и разорванные связи. Единственный субагент, которому доступна запись в knowledge-base/, и только по одному пункту с вашего утверждения.

Последний шаг любого ответа — verifier. Пока он не отработал, результат до вас не доходит:

• ответ со ссылками на базу выпускается, только когда каждая ссылка разрешилась в существующий файл и найденный в нём фрагмент;
• ответ «нет в базе» выпускается, только когда отсутствие подтверждено отдельным поиском.

Отсюда ограничение запуска: armarium вызывают только как агента верхнего уровня. Вложенным субагентом из другого агента проверка цитат молча не отработает.

Режимы

Режим агент выводит из формулировки запроса. Двусмысленный запрос он трактует в пользу безопасного чтения или спрашивает — записи по догадке не бывает.

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

Повседневный ритм

Главный цикл — дайджест и обратная связь по нему:

1. Запросите дайджест на устойчивом ритме, например раз в неделю.
2. Откройте то, что заинтересовало.
3. Сохраните стоящее заметкой в knowledge-base/ и поставьте тег #from-curator отдельной строкой — это отметка «нашёл агент».
4. Зафиксируйте изменения: git add -A и git commit.

Тег и коммит — единственный сигнал, по которому агент отличает попадание от промаха и затачивает вкус. Без них он этого не видит.

Разбор базы стоит проводить изредка, например раз в месяц, интерактивной сессией; прогнозы записывать по мере появления и сверять периодически.

Автоматизировать имеет смысл только дайджест — режимы с решениями остаются ручными. Простой путь — команда /schedule в сессии Claude Code. Для тех, кто уже работает с cron:

# каждый понедельник в 9:00 — недельный дайджест
0 9 * * 1  cd "/path/to/armarium" && claude --agent armarium -p "сделай недельный дайджест"

Границы и приватность

• База только читается вне режима обслуживания; свою работу агент пишет в служебную зону .claude/armarium/.
• Правки заметок — по одному пункту, с вашего утверждения и с пометкой авторства. Кнопки «применить всё» нет; отменить такую правку можно обычными средствами git.
• Свободного поиска по сети нет — агент ходит только по вашему списку источников.
• Содержимое заметок не попадает в веб-запросы: запрос строится из отслеживаемых тем и списка источников.
• Страница из сети читается как данные: инструкцию, встреченную на странице источника, агент не выполняет.
• Один пишущий за раз. Второй запуск поверх пишущего безвредно отступает, следующий по расписанию повторит окно.
• Всё или ничего. Прерванный запуск не оставляет следа и не обновляет наполовину «что уже показано».

Журнал запусков — .claude/armarium/logs/runs.md: дата, режим и исход каждого запуска.

Что дальше

• GUIDE.md — полное руководство: настройка, повседневные сценарии, разбор частых вопросов.
• README.md — обзор и справка по режимам с фразами-триггерами.
• .claude/armarium/sources.md — список источников, редактируете вы.
• global-context/global-context.md — профиль и отслеживаемые темы; обновляйте, когда меняется фокус.

Если агент отвечает «нет в базе», а вы уверены, что писали об этом: проверьте, что заметка лежит внутри knowledge-base/, сохранена и зафиксирована в git, и переспросите иными формулировками.