Новый код за час-два: разработчик советует пересматривать дизайн кода, а не латать правки

Раньше ошибки в коде правили точечно: нашли замечание, исправили, проверили снова. Автор заметки проверил этот цикл на практике и пришёл к выводу, что с ИИ-агентом (программой, которая сама пишет и проверяет код) правки по кругу почти никогда не дают чистого результата. Его рецепт: собрать все замечания и заново продумать устройство функции.

Что нового в подходе?

Автор каждый раз прогоняет сгенерированный по своему техническому заданию код через ревью (проверку) нескольких агентов с разными ролями. Получается что-то вроде взгляда нескольких людей с разным опытом. Замечания приходят почти всегда, от мелких до критических.

Главные наблюдения из заметки:

• Цикл «замечания, исправления, ревью» редко заканчивается тем, что агент не находит ничего нового.
• Чаще агент зацикливается на нескольких проблемах средней критичности и возвращает их снова и снова.
• Второй частый исход: код обрастает костылями и подпорками. Он работает, но поддерживать его потом очень трудно.
• Чистое состояние существует. Патч, принятый в Postgres (открытую систему управления базами данных) и переживший крупный релиз, те же агенты часто проходят без замечаний.
• Вывод автора: к чистому коду не прийти мелкими исправлениями, нужен пересмотр дизайна.

Сравнение автор берёт из своей прошлой области, вычислительной газовой динамики. Там компьютер шаг за шагом считает обтекание тела и ждёт, что расчёт устаканится. Иногда он разваливается, а иногда не сходится вовсе, потому что сам процесс постоянно колеблется. По словам автора, агентная разработка ведёт себя так же.

Проблема в том, что AI-агент никогда не скажет, что дизайн ошибочен, он мыслит в терминах исправлений. : Автор заметки, имя в публикации не указано

Цена приёма тоже названа. Система после пересмотра получается неидеальной, и местами страдает скорость работы. Зато разработчик знает, чем жертвует, и заранее прописывает компромиссы и контракты, то есть правила, по которым части программы взаимодействуют. Для СУБД (систем управления базами данных) стабильность автор называет критическим фактором.

Как попробовать приём сегодня?

1. Прогоните готовый код или текст через проверку нейросетью в нескольких ролях, например «строгий редактор» и «придирчивый пользователь».
2. Сделайте один круг исправлений. Если на втором круге возвращаются те же замечания, остановитесь.
3. Соберите все замечания в один список и задайте вопрос: какое устройство решения исключает эти проблемы в принципе?
4. Запишите, чем жертвуете ради стабильности, и только потом просите нейросеть сгенерировать новую версию.

Подойдут ли YandexGPT и GigaChat?

Приём не привязан к конкретной модели: автор сам пользуется Claude review, но суть в порядке работы, а не в инструменте. Из доступных в РФ аналогов, YandexGPT и GigaChat. Им можно так же задать роль ревьюера через промпт (текстовую инструкцию для нейросети).

Источник эти модели не тестировал. Сходится ли цикл правок у них, придётся проверить самостоятельно.

Что делать с этим прямо сейчас, по ролям?

Автору Дзена: если нейросеть третий раз подряд правит одни и те же места в статье, не переписывайте фразы. Пересоберите структуру текста: план, тезис, порядок аргументов.

Маркетологу: учитывайте, что генерация занимает час, а продумывание замысла занимает дни. Планируйте время на архитектуру кампании, а не на бесконечные правки готовых материалов.

Предпринимателю РФ и СНГ: приём бесплатный и работает с любыми доступными моделями. Если команда пишет код с ИИ, назначьте человека, который отвечает за дизайн, и не нагружайте его рутинной проверкой.

Ответы на частые вопросы о пересмотре дизайна

Это про дизайн-код города?

Нет. Дизайн-код города, это правила оформления улиц и вывесок. Здесь речь о дизайне кода, то есть о том, как устроена программа изнутри.

Значит, правки по замечаниям ИИ бесполезны?

Нет. Первый круг правок полезен. Сигнал к пересмотру появляется, когда замечания начинают повторяться или код обрастает подпорками.

Заменит ли ИИ-агент разработчика?

Автор видит другое: людям придётся становиться архитекторами, оставив написание кода агенту. Но и в этой роли спускаться к построчной проверке всё равно нужно, потому что опыт команды за 20 с лишним лет в ограниченную память модели не поместить. Побеждает тот, кто умеет вовремя остановить правки и переделать замысел.