На r/ClaudeCode чувак опубликовал «самый приятный PR в карьере» - унаследовал репо от «агентного инженера», переписал за неделю с Клодом, скинул скриншот. Ок, давайте разбираться.
Вот что было в том репо:
- 220 хэндлеров, из которых реально нужны ~20 (ещё 5 можно было убрать)
- 40+ секретов, из которых для работы нужны 2
- 309 000 строк кода
- 240 000 строк документации
- логи в md-файле на миллион строк
Он переписал это за неделю с Клодом, сохранив функциональность, но с нормальной архитектурой и интеграционными тестами.
- автор поста на r/ClaudeCode
Это хорошо. Правда хорошо.
Но меня зацепило другое - пропорция. 309k строк кода при 240k строк документации. Это не репозиторий, это музей самого себя. Когда документация занимает 77% от объёма кода - агент перестал строить продукт и начал вести летопись собственного строительства.
Я понимаю, как это происходит. Запускаешь агента, он делает что-то непонятное, ты добавляешь ещё один AGENTS.md (это файл-инструкция - что агенту делать, чего не трогать), потом ещё один skills-файл, потом лог сессии, потом документ «архитектурные решения». И через месяц у тебя гора бумаг вместо работающего продукта.
Классическое «написал 500 страниц инструкций для строителей вместо того чтобы нарисовать план дома».
Я сам так делал - не в таких масштабах, но делал. В какой-то момент у меня в одном проекте накопилось штук 8 разных markdown-файлов для агента. Каждый «важный». Потом я их все прочитал подряд и понял: половина противоречит другой половине, а агент просто игнорировал большую часть из них. Снёс всё, оставил два файла. Стало лучше.
Комментарий в треде, который мне понравился больше всего:
Вы будете удивлены, насколько эти инструменты мощны для опытного архитектора или инженера, который понимает сервисы, переиспользуемый код, архитектурные паттерны с самого начала.
- u/radioref
Это точно. Клод умножает то, что у тебя уже есть. Если у тебя есть понимание, как должна выглядеть система - он поможет это построить быстрее. Если понимания нет - он быстро построит непонятно что. И непонятно что будет очень убедительно выглядеть: много файлов, много документации, сложные agent roles, «конволютные методы документирования всего, что происходит в репо».
Поэтому я всегда немного скептически смотрю на истории типа «я за неделю с агентом переписал унаследованное легаси». Может, да. Но с другой стороны:
Это PR, который невозможно ревьюить. Даже если игнорировать весь удалённый код - у кого есть время разобраться в 10 тысячах строк добавлений?
- u/dark_vaterX
Вот это реальная инженерная проблема. Ты переписал систему. Замечательно. Но твой коллега это не проверит нормально. Он просто скажет «LGTM» и смёрджит. А потом что-то сломается в проде в пятницу вечером, и никто не поймёт где именно.
Правильная история про большой рефакторинг выглядит по-другому: ветка рефакторинга, из неё маленькие PR по кускам, каждый ревьюится нормально. Скучно, да. Но работает.
И последнее про «а все хвалили его за передовые агентные подходы». Вот это больно читать, потому что знакомо. Техническая сложность хорошо выглядит со стороны. Куча файлов с разными agent roles, логи в отдельный markdown, custom pipeline, который в цикле строит функциональность - это звучит круто на стендапе. Особенно если остальные в команде не очень понимают, как это работает.
Напоминаю: многие из тех, кто хвалит вайбкодинг, не являются software professionals.
- u/LivingMaterial7288
Ну и да. Если некому проверить качество - проверяется только наличие результата.
Итог простой: если у тебя документации больше, чем кода - это не признак зрелой системы. Это признак того, что агент потерялся и начал компенсировать это описаниями. Строй меньше, но то, что нужно. Держи репо чистым с первого дня. AGENTS.md на 2-3 файла максимум - и только то, без чего агент реально ломается.
А чистить потом Клодом - да, работает. Я проверял)
p.S. Самый смешной комментарий в треде - от u/EEKman: «Я senior vibe engineer, объясните мне, что означают эти красные цифры? Клоду нужно зелье здоровья?» 😂 Вот вам и аудитория, которая хвалила того инженера.