Референсы для агентов

Допустим, у нас есть огромная документация по проекту. Архитектура, API, база данных, тесты, деплой. Если загружать её целиком в контекст агента, она займёт значительную его часть ещё до начала работы.
При этом для конкретной задачи большая часть этих сведений может вообще не понадобиться. Чтобы поменять кнопку в интерфейсе, вряд ли нужно читать подробную инструкцию по миграциям базы)

Такую документацию можно разбить на отдельные файлы. А в стартовом файле оставить общие правила и ссылки на нужные разделы — референсы.

Но рядом со ссылками важно написать, когда читать каждый файл. Например:
- references/api.md — прочитай перед добавлением или изменением API.
- references/database.md — прочитай перед изменением схемы базы или созданием миграций.
- references/testing.md — прочитай перед написанием и запуском тестов.
И явно указать: «Читай дополнительные файлы по мере необходимости для текущей задачи».
Если какой-то раздел тоже разросся, его можно разделить дальше: оставить в нём краткое описание и ссылки на более подробные инструкции с такими же условиями чтения.

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