Возникла идея провести серию работ по применению ИИ агента в легаси проектах. Для этого взял реальный заброшенный Java-проект (Spring Boot 2, не обновлялся ~6 лет) и методично прогонял через него Claude Code: погружение в незнакомый код, тесты, миграция на актуальный стек, рефакторинг.

Каждый шаг фиксирую в журнал — с числом моих вмешательств, тем, где агент ошибся, и выводом «что бы я сказал заказчику, если бы это была его команда».

Это не «ИИ решает всё за вас» и не «ИИ ничего не может» — оба тезиса продаются, но плохо описывают реальность. Задача серии — показать конкретный, воспроизводимый протокол: что агент реально умеет на незнакомом легаси проекте, где нужен контроль сеньора, а где он лишний.

Методология коротко * Сначала сам разбираюсь в структуре без агента — это база для сравнения. * Затем агент строит карту модуля дважды: без контекста и с системным файлом (CLAUDE.md). Сравниваю качество. * Отдельно прогнал модный оркестрационный фреймворк (GSD, параллельные субагенты) на том же коде — и поймал забавный кейс: агент уверенно описал тест по имени файла, ни разу не заглянув внутрь. * Пишу тесты на текущее (не «правильное») поведение — это защита и лакмусовая бумажка для всех дальнейших исправлений и вмешательств. * Мигрирую на Spring Boot 3 и Java 21 — и именно здесь всплыла самая неожиданная находка всей серии: обновление фреймворка не просто не исправило один из багов, а сделало его незаметным. Раньше он падал громко и всегда. Теперь — тихо и не всегда. Про это будет отдельный пост. * Дальше — рефакторинг под защитой тестов, с решением, что чинить в первую очередь.

Каждый пост серии — один конкретный вывод, без воды: что случилось, почему это важно, что бы это значило для реальной команды. Никакого «10 лайфхаков по промптингу» — только то, что реально наблюдалось на конкретном коде.

Первый содержательный пост — про то, оправдывает ли себя системный контекст-файл для агента, или это карго-культ. Дальше — про многоагентные фреймворки, про баги, которые находят только тесты, и про самую неожиданную находку — миграцию, которая замаскировала дефект вместо того, чтобы его исправить.