Нейминг заметок, который находит агент

Если бы меня попросили назвать одно решение, которое сильнее всего повлияло на работу с базой знаний, я бы назвал не инструмент и не плагин. Я бы назвал формулу имени файла.

Формула

{проект} {тип} описание – ГГГГ-ММ-ДД.md

Например: {levsha} protocol deploy-vps – 2026-07-06.md. Проект в фигурных скобках, тип из фиксированного списка (guide, note, protocol, research, retro...), описание маленькими буквами, дата через длинное тире.

Выглядит бюрократией. Даёт три суперспособности.

Поиск по маске. Агенту не нужен полнотекстовый индекс, чтобы найти «последний протокол деплоя»: маска по имени + сортировка по дате в имени. Работает мгновенно и не ломается.

Версионность без версий. Обновилось понимание — пишется новый файл с новой датой. Старый остаётся историей. «Самый свежий по дате в имени» — простое правило, которое агент выполняет без ошибок.

Сортировка сама раскладывает. Файлы одного проекта стоят рядом, внутри проекта — по типам, внутри типа — хронология. Никакой ручной уборки.

Пара граблей

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

Главный тест

Хорошее имя файла проходит один тест: агент, никогда не видевший этой заметки, находит её по словам из моей задачи. Не нашёл — имя плохое, переименовываю. Красота структуры без находимости не стоит ничего.