Над этим вариантом я ещё думаю.
Есть две идеи:
1. Пойти по стопам
https://packagist.org/packages/mpociot/laravel-apidoc-generator - он тупо газлом прётся на урл, получает и ответ, который записывает в доку.
2. Всё-таки в док-блок добавлять аннотацию с ссылкой на класс ответа, который будет дёргаться при формировании.
Полностью отказаться от док-блоков нельзя. Не получится. Как минимум, оттуда будут браться заголовки и описания.
Но и текущий объем в других пакетах это ужас. Слишком много всего. Хочу максимально автоматизировать и упростить.