Компактная документация для агентов — отрицательный результат
Саммари
Работа проверяет базовое допущение всей индустрии: что хорошая документация помогает кодинг-агенту решать задачи. Проверяли на двух семействах моделей и десяти репозиториях, с положительным контролем, подтверждающим, что методика вообще способна увидеть улучшение. Ответ отрицательный.
Из этого следует: инвестиции в документацию оправданы не как способ ускорить агента при наличии кода, а как способ сделать код читаемым для человека и для сценариев, где исходник недоступен.
На практике для Revit-проекта это меняет приоритеты: раз доступны файлы Revit-плагина, вкладываться в автогенерируемую документацию ради агента — деньги в никуда; полезнее тесты и структурные проверки.
Важный нюанс: отрицательный результат не означает «документация бесполезна». Авторы прямо очерчивают границу, где она помогает, — просто эта граница не там, где её обычно ищут.