Мы делаем заранее. Сначала я пишу дизайн-решение по изменениям с примерами в виде сваггера конкретных эндпоинтов, потом аналитики берут это переваривают в документацию и добавляют в общий гигантский сваггер на конфлюенсе, создают задачи на разработку, потом бэк и фронты берут задачи. Всё просто, кроме совметного редактирования одного документа разными аналитиками одновременно и понимания на каком стенде какая версия апи раскатана, это вот думаем как решить