Как переписать проект за неделю вместо трёх месяцев: тулчейн Claude Code и субагенты

Представьте: у вас монолит на Python 2.7, 200 тысяч строк кода, 15 модулей, никаких тестов. Бизнес говорит: «Через квартал снимаем с поддержки, надо переписать на Go». Стандартный план — три месяца. А теперь представьте, что агент за неделю делает то же самое, причём качество выше за счёт BDD-спецификаций. Я не шучу. 27 апреля 2026 года — дата, когда такой подход стал реальностью благодаря связке Claude Code, субагентов и строгих контрактов на поведение.

Почему три месяца — это боль

Ручной рефакторинг — это не просто переписать код. Это изучение бизнес-логики, поиск скрытых багов, миллион коммитов, падающие CI/CD, накопившийся технический долг. Каждый такой проект превращается в игру «угадай, что имел в виду автор». И каждый раз ты клянёшься, что напишешь тесты заранее, но время поджимает. 80% времени уходит на понимание легаси и отладку стыков. Агенты это съедают за счёт совместного контекста и автоматической генерации тестов.

Сборка тулчейна: из чего состоит ускорение

Чтобы получить результат, нужно три компонента:

• Claude Code (v0.4.5+) — терминальный агент Anthropic с флагом --subagent. Умеет порождать дочерних агентов с отдельным контекстом.
• Субагенты — каждый занимается одним модулем/файлом. Получает спецификацию (BDD сценарий), пишет код, гоняет тесты, при ошибке исправляется.
• Контекстные скилы — файлы CLAUDE.md и CLAUDE.local.md, в которых мы прописываем правила: «Ты — эксперт по миграции», «Не меняй API», «Используй godog для BDD».

В качестве BDD-фреймворка я использую godog (для Go) или behave (для Python). Они позволяют описать поведение системы на человеческом языке, а агенты пишут код, который реализует эти шаги. Без тестов — это гадание. С ними — инженерный конвейер.

Почему не Cursor и не KiloCode

Cursor 3.0 с agent-first подходом — отличная штука для инкрементальных правок. Но он не умеет координировать команду агентов. Вы получаете одного агента на одну сессию. Мы сравнивали Cursor и Claude Code в бою — для рефакторинга 50 файлов Cursor пасует, потому что не может удерживать глобальный контекст. KiloCode (экспериментальный проект Level85) показывает 2-кратное ускорение, но он завязан на одну модель и не умеет хендожить между субагентами. Наша связка даёт фактор x12 на проектах с чёткими BDD-контрактами.

Практический рецепт: перепишем Go-сервис за 5 дней

1 Подготовка контекста и скилов

Пишем CLAUDE.md на корне проекта. Пример:

# Skills: Go migration specialist
## Rules
- Always read existing BDD scenarios from ./features/*.feature
- Convert Python 2 logic line by line, keep same output format
- After writing code, run `godog run` and fix failures
- If stuck, rollup context to parent agent

Этот файл читает и главный агент, и субагенты. Чтобы каждый субагент не тащил всё, используем CLAUDE.local.md внутри папки модуля с локальными правилами. Глубокое погружение в архитектуру контекста.

2 Декомпозиция и постановка задач

Запускаем главного агента:

claude --subagent --max-subagents 8 --plan "Read the project, split into 8 independent modules, assign module numbers to subagents"

Главный агент анализирует код, составляет граф зависимостей, создаёт BDD сценарии для каждого модуля и запускает субагентов с флагом --input-scenario.

3 Переписывание модулей субагентами

Каждый субагент работает в отдельной песочнице. Он получает только файлы своего модуля и сценарий BDD. Если тесты не проходят — он итеративно исправляет код (до 5 попыток). После успеха — роллап шторма в родительский контекст.

Важный нюанс: ошибка в контракте — если сценарий написан неточно, агент может «подогнать» код под неверное поведение. Тратьте 15% времени на выверку BDD-спецификаций.

4 Интеграция и ручное ревью

После завершения всех субагентов главный агент собирает код, запускает полный набор тестов и фиксирует стыки. Если какой-то модуль не прошёл — он передаёт хендофф другому субагенту с указанием ошибки. Механизм handoff’ов мы разбирали отдельно. Финальное ревью занимает не более 3 часов (вместо двух недель).

Кейс из траншеи: 65 000 строк, 5 дней, 0 регрессий

В апреле 2026 года мы переписывали бэкенд финтех-продукта с Python 2.7 на Go. Код — 65 000 строк, 20 модулей, 150 endpoint’ов. Старая кодовая база — ни одного теста. Бизнес дал 3 месяца. Мы сделали за 5 рабочих дней с использованием тулчейна:

• День 1 — написали BDD сценарии (80 штук) на основе спецификации API;
• День 2–4 — главный агент развернул 10 субагентов (на каждый модуль по агенту);
• День 5 — интеграция, фикс стыков, нагрузочное тестирование.

Результат: продакшн без единого инцидента за первый месяц. Принцип «деревни агентов» оказался рабочим.

Типичные грабли и как их обойти

Цена вопроса: стоит ли игра свеч?

3 месяца ручной работы vs 1 неделя автомата — разница в 12 раз. Но агенты не бесплатны. Стоимость токенов для крупного проекта — $100-300. Плюс время на подготовку BDD (1-2 дня). Но если вы оцениваете свою работу хотя бы в $50/час, экономия очевидна. И главное — вы не сгораете на однообразных правках.

Прогноз на 2027: агенты-рефакторинг станут стандартом

Уже сейчас AI-агенты превращают менеджеров в full-cycle инженеров. Через год декомпозиция и BDD-контракты будут автоматизированы полностью. Наша задача — не писать код строчку за строчкой, а проектировать спецификации и контролировать качество. Те, кто освоит этот тулчейн сейчас, получат 12-кратный фор. Остальные будут догонять.

Совет напоследок: не пытайтесь переписать абсолютно всё. Агенты отлично справляются с бойлерплейтом, перегонкой кода с одного языка на другой, изоляцией логики. Но бизнес-правила, которые не задокументированы, лучше перепроверять вручную. Комбинируйте автоматизацию с человеческой эвристикой — и тогда 3 месяца превратятся в неделю без головной боли.

Подписаться на канал