Wikilinks — как связи заменяют папки в базе знаний

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

Первую сотню заметок я честно раскладывал по папкам. Потом появилась заметка про Telegram-бота для клиентского проекта — и вопрос: она про Telegram, про клиента или про ботов? Три папки претендуют, лежать она может в одной. С этого места иерархия начала проигрывать.

Ссылка вместо ящика

Wikilink — это ссылка из одной заметки на другую по имени: упомянул [[защита секретов]] — получил связь. Заметка больше не «лежит в ящике», она висит в сети: про Telegram, про клиента и про ботов одновременно, без дублей и без мучительного выбора полки.

Папки у меня остались, но несут только грубую сортировку: проекты, люди, инфраструктура. Настоящая навигация — по связям.

Три правила, чтобы это работало

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

Битая ссылка — это нормально. Wikilink на заметку, которой ещё нет — не ошибка, а закладка: место, где знанию предстоит появиться. У меня таких десятки, и часть из них со временем превращается в полноценные материалы.

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

Что это даёт агенту

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

На этом же принципе построен и этот сайт: блок «по теме» под каждым материалом — те же wikilinks, только наружу. И проверка на сирот здесь тоже работает: материал без связей не проходит сборку. Правило из личной базы дожило до прода.

ПРИМЕНИТЬ У СЕБЯ

Повторяете такой же контур и застряли? Напишите, где именно — разберём вашу ситуацию, а не абстрактный пример.

Telegram @bosswor