Разработчик превратил недельный кошмар рефакторинга в координированную работу 15 AI-агентов, которые за несколько часов обновили 56 файлов в 12 модулях. Подход показал, как превратить техдолг из вечно откладываемой задачи в решаемую проблему.
Проблема знакома каждому: модульный монолит с чистой архитектурой постепенно накапливает несоответствия. В одном модуле методы бросают исключения, в другом — возвращают Result. Рефакторинг очевиден, но механическая работа с десятками файлов проигрывает новым фичам в приоритетах продуктового менеджера.
«Месяцы проходят, несоответствия распространяются, когнитивная нагрузка растёт», — описывает автор классический сценарий накопления техдолга.
Один агент работает, остальные ждут
AI-ассистенты вроде OpenCode решили часть проблемы — они понимают контекст и следуют сложным правилам трансформации кода. Но остаётся узкое место: один агент обрабатывает файлы последовательно.
Первая попытка заняла 45 минут на 2 из 14 фаз рефакторинга. Простая арифметика показала 4-5 часов общего времени — лучше ручной работы, но всё ещё медленно для крупных изменений.
15 окон браузера — 15 независимых агентов
Прорыв оказался простым: детальный план рефакторинга разбили на независимые фазы. Каждый AI-агент получил конкретную задачу:
- Фаза 3: эндпоинты модуля Timesheets
- Фаза 4: эндпоинты модуля Projects
- Фаза 5: эндпоинты модуля Billing
Агенты работали параллельно в разных файлах без конфликтов. Общий документ refactor-plan.md содержал единые правила трансформации и чек-лист для каждой фазы.
(Для справки: OpenCode — AI-инструмент для рефакторинга, который понимает контекст кода и может выполнять сложные трансформации по текстовым инструкциям.)
Экономика AI-рефакторинга
Подход решает главную проблему техдолга — экономическое обоснование. Когда рефакторинг занимает часы вместо недель, его становится проще включить в спринт наравне с фичами.
Метод работает для любых масштабных изменений: миграция библиотек, обновление паттернов, стандартизация подходов. Главное условие — возможность разбить работу на независимые части.
Техника превращает AI-ассистентов из «быстрых исполнителей» в координированную команду разработчиков.