Главная / Блог / AI-агенты пишут код быстро

AI-агенты пишут код быстро: как сохранить управляемость архитектуры сайта

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

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

Что ломается первым

Отдельные правки редко ломают сайт сразу. Чаще они накапливаются и бьют по четырем уровням:

УровеньСимптомКак проверить
Структура страницыблоки добавляются по запросам, путь пользователя не читаетсяпройти страницу глазами нового посетителя и назвать следующее действие на каждом экране
Логикаодна задача решена двумя способами, правка чинит одно место и задевает другоенайти дублирующиеся обработчики и условия, добавленные под конкретный баг
Стилиодни и те же отступы и компоненты заданы по-разному в разных местахсравнить три однотипных блока: отступы, шрифты, состояния кнопок
Контенттексты заполняют места, но не отвечают на вопросы клиентапрочитать страницу и выписать, чем компания отличается от трех конкурентов

Порядок работы, который держит архитектуру

  1. Зафиксировать карту сайта до генерации кода: страницы, их задачи, переходы между ними.
  2. Ставить агенту одну задачу за раз. Смежные улучшения - отдельной задачей после проверки первой.
  3. Проверять каждую правку в браузере, а не по отчету агента. Уверенное объяснение агента не равно корректному результату.
  4. Проводить ревизию накопленных правок: убирать дубли и подходы, которые появились временно.
  5. Вести короткий список принятых решений: что выбрано и почему. Без него через месяц никто не помнит, зачем все устроено именно так.

Минимальный набор правил для агента выглядит так:

# Правила для агента
- одно изменение за раз, без смежных правок;
- новая зависимость только после явного подтверждения;
- после каждой правки: что изменено и где это проверить.

Что поручать агенту, а что оставлять человеку

Агент ускоряетЧеловек решает
Код по заданной структуреКарта сайта и структура страниц
Рутинные правки и верстка состоянийКакие блоки нужны, а какие - лишние
Поиск багов по логам и симптомамАрхитектура, зависимости, точки роста
Черновики текстов по фактам компанииФакты, отличия, аргументы для клиента

Частые вопросы

Ревизия уже собранного сайта

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

Архитектура - это список принятых решений, а не объем кода. Агент пишет код быстрее человека, но решения за него принимать некому. Кто фиксирует решения, тот и контролирует сайт. Про проверку решения до запуска и цену переделок - отдельная статья: Сайт своими руками с помощью AI.

Чтобы не пропустить новые материалы

Короткий дайджест вечером в понедельник. Без спама.

Выберите, что получать

Обсудим ваш проект

Расскажите о вашем бизнесе, покажите текущий сайт или просто опишите задачу в свободной форме. Я изучу вводные, предложу решение и сориентирую по срокам и смете.

Отвечаю в течение нескольких часов в рабочее время.

Защита от спама – Yandex SmartCaptcha

Если вам удобнее обсудить всё текстом без заполнения форм – напишите напрямую: в Telegram или на sergei@kruglov.net

Удобнее голосом? Напишите пару слов о задаче - договоримся об удобном времени созвона на 15-20 минут, и я пришлю свой номер телефона.