Инструмент · llm-wiki

Разрозненные записи превращаются в базу знаний, которую ведёт агент

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

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

Что было и что стало

Раньше

  1. Придумать структуру папок заранее
  2. Разложить материалы по ней руками
  3. Обнаружить, что реальная практика в структуру не влезает
  4. Придумать структуру заново
  5. Бросить

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

Сейчас

  1. Положить источник в raw/ и сказать «проиндексируй»
  2. Обсудить с агентом, что он вытащил
  3. Он пишет страницы и сам расставляет ссылки между ними
  4. Спрашивать базу словами, ответ приходит со ссылками на источник

Категории агент придумал сам, исходя из материала. Ни одна ссылка между страницами не поставлена руками.

Доказательство: одна собранная база

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

295страниц в вики
228описанных приёмов
16разобранных команд
3исходных файла на входе
Что лежит на входе
raw/ — три выгрузки рабочих досок, дальше не трогаются
wiki/ — 36 понятий · 228 приёмов · 15 паттернов · 16 разборов
index.md — каталог, точка входа для любого вопроса
log.md — журнал: что и когда индексировалось
Что получилось на выходе — фрагмент страницы паттерна
# Паттерн: продукт строится из бэклога, а не из запроса рынка

Тип: узкое место на старте трека
Где встречалось: [[команда A]] · [[команда B]] · [[команда C]]

## Суть
Команда уверенно движется и производит артефакты, но ни разу не назвала,
чью работу её продукт отменяет и кто за это платит.

## Признаки, по которым ловится
— На вопрос «чью работу отменяем» отвечают через свойства продукта.
— Метрики измеряют использование, а не деньги.
— Есть выпущенный кусок продукта, по которому не смотрели цифры.

## Связи
[[методы/попытка-фальсификации-цели-и-метрики]]
[[методы/в-чём-проблемы,-а-не-джобы]]
Названия команд заменены буквами. Страницу целиком написал агент, ссылки в блоке «Связи» он расставил сам, найдя связанные приёмы среди остальных 227.
Что база отвечает на вопрос к самой себе
— 94 приёма из 228 — это реплика в моменте: большая часть арсенала
  ничего не стоит и применяется на лету.
— 69 приёмов работают на стадии входа и диагностики: база смещена
  в начало работы с командой.
— у 163 приёмов нет стыковки с методологией — это честная дырка,
  а не полнота.
Последняя строка — то, ради чего всё и делалось: база показывает не только что в ней есть, но и чего в ней нет.

Как устроено

Два слоя вместо одного

Источники лежат отдельно и никогда не правятся. Страницы, которые пишет агент, лежат отдельно и правятся свободно. Если страница вызывает сомнение, всегда видно, из какого источника она выросла.

Компиляция вместо поиска

Обычный подход — искать ответ в документах заново на каждый вопрос (это называют RAG, retrieval-augmented generation: поиск фрагментов плюс генерация ответа по ним). Здесь наоборот: связи между материалами строятся один раз при индексации, а вопрос обращается к уже готовым страницам. Дорого и редко — собрать, дёшево и часто — спрашивать.

Каталог как точка входа

Один файл-каталог со строкой на каждую страницу. Агент читает его, а не всю базу, поэтому вопрос не съедает контекст: в мелкие файлы он идёт, только если ответа на верхнем уровне не хватило.

Человек в цикле

По умолчанию источники индексируются по одному, и агент сначала обсуждает, что он вытащил, и только потом пишет. Пакетная загрузка возможна, но это отдельное решение, а не поведение по умолчанию.

Где ломается

Как взять себе

Скилл ставится в папку агента и вызывается по имени. Нужен агент, работающий с локальными файлами: Claude Code, Codex или аналог.

npx degit kulakov/skill-collections/frequent/skills/llm-wiki ~/.claude/skills/llm-wiki

Дальше: llm-wiki init — завести базу, llm-wiki ingest <файл> — положить первый источник, llm-wiki query «вопрос» — спросить. На первую полезную базу уходит один вечер и три-четыре источника.