🔗 Аннотированные md ссылки


Ещё один приём, который несмотря на простоту является важным инструментом контекст инжиниринга.

Я назвал его "аннотированные ссылки".

Когда необходимо добавить ссылку на другой md файл, я ввёл для агентов правило оформлять её как "аннотированную md ссылку". Формат такой:

- в маркдауне один из вариантов оформления ссылки - это сочетание текста в квадратных скобках и сразу за ними ссылка в круглых скобках
- текст в квадратных скобках - это то что видит пользователь, оно может быть выделено как ссылка (синий цвет, подчёркивание)
- ссылка в круглых скобках - это url по которому система будет переходить по клику
- я требую в квадратных скобках указать абсолютное имя файла от корня проекта, например "[.memory-bank/product.md]"
- в круглых скобках система указывает относительный путь к целевому файлу (относительно папки текущего документа)
- ВАЖНО: следом идёт двоеточие и все то же описание файла из тэга description


❓ Нафига "козе баян"?

Все те же соображения "ускорения". По аннотированной ссылке агенту гораздо легче принять решение о чтении файла (или, что тоже важно - НЕ ЧТЕНИИ), чем пытаться "угадать по трём нотам" имени файла чего там внутри. Семантические имена файлов немног опомогают, но полноценный description помогает значительно сильнее.

❓Почему два формата записи путей?

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

❓Зачем относительный путь?

Может сработать в markdown просмотрщиках, хотя нам важно дать инфу агентам.



#post
@deksden_notes