"🔗 Аннотированные md ссылки Ещё один приём, который несмотря на простоту является важным инструментом контекст инжиниринга. Я назвал его ""аннотированные ссылки"". Когда необходимо добавить ссылку на другой md файл, я ввёл для агентов правило оформлять её как ""аннотированную md ссылку"". Формат такой: - в маркдауне один из вариантов оформления ссылки - это сочетание текста в квадратных скобках и сразу за ними ссылка в круглых скобках - текст в квадратных скобках - это то что видит пользователь, оно может быть выделено как ссылка (синий цвет, подчёркивание) - ссылка в круглых скобках - это url по которому система будет переходить по клику - я требую в квадратных скобках указать абсолютное имя файла от корня проекта, например ""[.memory-bank/product.md]"" - в круглых скобках система указывает относительный путь к целевому файлу (относительно папки текущего документа) - ВАЖНО: следом идёт двоеточие и все то же описание файла из тэга description ❓ Нафига ""козе баян""? Все те же соображения ""ускорения"". По аннотированной ссылке агенту гораздо легче принять решение о чтении файла (или, что тоже важно - НЕ ЧТЕНИИ), чем пытаться ""угадать по трём нотам"" имени файла чего там внутри. Семантические имена файлов немног опомогают, но полноценный description помогает значительно сильнее. ❓Почему два формата записи путей? Агенты регулярно путаются в папках, в которых находятся. перешли, и забыли что перешли. Консистентное использование абсолютных путей от корня проекта помогает им меньше совершать ошибок. Правило использования абсолютных путей полезно прописывать в контекст каждому агенту. ❓Зачем относительный путь? Может сработать в markdown просмотрщиках, хотя нам важно дать инфу агентам. #post @deksden_notes"