Агент Librarian — база знаний без накопленного хаоса
Как агент Librarian в Datarim поддерживает порядок в директории datarim/, выстраивает перекрёстные ссылки и выявляет противоречия — не меняя смысла ни одного документа.
В любом проекте документы накапливаются быстрее, чем систематизируются. PRD трёхмесячной давности ссылается на задачу, которую переименовали. Два файла рефлексий описывают один и тот же урок разными словами. Индексная страница по-прежнему содержит файл, которого больше нет. Сборку это не ломает, поэтому так и остаётся. Со временем база знаний превращается в место, где ответ где-то есть, но найти его дольше, чем вывести заново.
Агент Librarian существует, чтобы предотвратить этот дрейф. Он запускается на /dr-dream, и его область — исключительно директория datarim/: не исходный код, не конфиги, только институциональные знания проекта.
Три режима работы
Ingest обрабатывает новые и неправильно размещённые файлы: перемещает их в нужную директорию, исправляет несоответствия в именовании, добавляет отсутствующие метаданные. Lint — это проверка здоровья: поиск документов-сирот, на которые ничто не ссылается, сломанных перекрёстных ссылок, устаревшего контента и непоследовательных названий. Consolidation идёт дальше: объединяет дубликаты, извлекает повторяющиеся паттерны, создаёт или обновляет индекс, добавляет двунаправленные ссылки — если документ A ссылается на B, то B тоже ссылается на A.
Каждое действие Librarian добавляется в datarim/history/activity-log.md, поэтому история обслуживания всегда доступна для проверки.
Чего он не делает
Librarian выявляет противоречия — конфликтующие утверждения в разных документах — но не разрешает их. Разрешение противоречия требует суждения о том, какой документ является авторитетным, а это человеческое решение. Агент помечает конфликт вызовом-предупреждением и останавливается. Аналогично, файлы никогда не удаляются молча: удаления предлагаются, а не исполняются, пока оператор не одобрит.
Практический пример
После серии задач Librarian может сообщить: два файла рефлексий, обсуждающих один урок по деплою под разными заголовками (кандидат на объединение); один PRD, ссылающийся на документ с планом по имени файла, которое впоследствии было изменено (сломанная ссылка); четыре задачи в индексе, помеченные как активные, хотя две недели назад отправленные в архив (устаревшие записи). В отчёте предлагаются исправления; ничего не меняется, пока оператор не даст разрешение.
Место в пайплайне
Librarian работает на модели класса Sonnet. Организационная работа структурирована и повторяема — она не требует тяжёлого рассуждения, зарезервированного для архитектурных или секьюрити-решений. Агент достаточно лёгкий, чтобы запускаться в конце спринта как плановый проход обслуживания, а не только когда что-то явно сломалось.
Полный список возможностей — на карточке агента Librarian, а общую картину даёт пост что такое Datarim.