У нас сейчас фронты делают отдельный GIT репозитарий, где пишут Swagger через YAML, разбивают все по файлам, потом мы добавляем это в CI и в итоге требования к API публикуются на
https://spec-api.project.com Ребята из бэка видят требования отсюда, но поддерживать в будущем такую спецификацию становится сложнее. Что бы что-то поменять: нужно перейти в репозитарий, закомиттить, дождаться CI и т.д.