Команда /dr-dream — обслуживание базы знаний
Как /dr-dream организует, дедублирует и перекрёстно ссылает базу знаний datarim/ — инвентаризация, линтинг, консолидация и пересборка индекса в трёх режимах.
В каждом проекте со временем накапливаются документы: PRD, планы, рефлексии, архивы. После достаточного числа завершённых задач связи между файлами размываются. Что-то было решено в рефлексии, но так и не связано с соответствующим PRD. Два плановых документа пересекаются на семьдесят процентов. Какая-то директория стоит пустой. /dr-dream устраняет этот дрейф.
Название следует биологической аналогии: как сон консолидирует память, Dream консолидирует знания. Работа происходит в директории datarim/ и documentation/archive/ — не в исходном коде, не в конфигах, только в институциональных знаниях проекта. Выполняет её агент Librarian.
Три режима
Запуск /dr-dream без аргументов запускает полное обслуживание: инвентаризация, линтинг, предложения по консолидации и пересборка индекса — примерно две-пять минут. /dr-dream lint выполняет только проверки состояния без изменений, около минуты. /dr-dream index пересобирает только datarim/index.md за тридцать секунд.
Рекомендуемая периодичность — каждые десять-пятнадцать завершённых задач, или после любого запуска /dr-archive, создавшего более пяти новых документов.
Что проверяет полный проход
Шаг инвентаризации сканирует каждый файл .md в обеих директориях, фиксируя путь, размер, поля frontmatter, входящие и исходящие ссылки. Шаг линтинга ищет противоречия между документами, устаревшие ссылки на завершённые задачи, всё ещё помеченные как активные, осиротевшие файлы без входящих ссылок, дублирующийся контент с пересечением выше семидесяти процентов, нарушения симметрии перекрёстных ссылок и файлы-«тяжеловесы» длиннее пятисот строк.
Далее следуют предложения по консолидации: кандидаты на слияние, добавление перекрёстных ссылок, пробелы в frontmatter, неправильно расположенные файлы, несоответствия именования. Ничего из этого не применяется автоматически. Команда показывает список и ждёт явного подтверждения перед любыми изменениями.
Индекс
Каждый полный проход или запуск /dr-dream index перезаписывает datarim/index.md. Индекс каталогизирует все документы по типу, группирует по тегам frontmatter там, где они есть, перечисляет последнюю активность и показывает метрики графа знаний: общее число документов, число связей и число осиротевших файлов. Это точка входа для навигации по накопленным знаниям проекта без перебора отдельных файлов.
Лог и следующие шаги
После каждого запуска краткое описание обслуживания добавляется в datarim/history/activity-log.md. Если проход обнаруживает дрейф фреймворка — инструкции в скилах стали несогласованными — следующий рекомендуемый шаг: /dr-optimize, который работает со структурными проблемами на уровне фреймворка, а не базы знаний.
Общая картина фреймворка — в посте что такое Datarim. Об агенте, который выполняет эту работу, читайте в посте агент Librarian.