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