AI-агенты пишут код быстро: как сохранить управляемость архитектуры сайта
Если код сайта пишут AI-агенты, управляемость сохраняется только при одном условии: архитектура и продуктовые решения остаются за человеком. Агент - исполнитель отдельных задач. Как только ему передают и сами решения (структуру, сценарии, выбор компонентов), сайт начинает расти без проекта: каждый кусок по отдельности работает, а целое расползается.
Нейрослоп - генерация вместо проектирования: код, тексты и картинки создаются без ответа на вопрос, каким должен быть продукт и зачем. Проверка показывает: чем дешевле отдельная правка, тем дороже обходится отсутствие проекта в целом.
Что ломается первым
Отдельные правки редко ломают сайт сразу. Чаще они накапливаются и бьют по четырем уровням:
| Уровень | Симптом | Как проверить |
|---|---|---|
| Структура страницы | блоки добавляются по запросам, путь пользователя не читается | пройти страницу глазами нового посетителя и назвать следующее действие на каждом экране |
| Логика | одна задача решена двумя способами, правка чинит одно место и задевает другое | найти дублирующиеся обработчики и условия, добавленные под конкретный баг |
| Стили | одни и те же отступы и компоненты заданы по-разному в разных местах | сравнить три однотипных блока: отступы, шрифты, состояния кнопок |
| Контент | тексты заполняют места, но не отвечают на вопросы клиента | прочитать страницу и выписать, чем компания отличается от трех конкурентов |
Порядок работы, который держит архитектуру
- Зафиксировать карту сайта до генерации кода: страницы, их задачи, переходы между ними.
- Ставить агенту одну задачу за раз. Смежные улучшения - отдельной задачей после проверки первой.
- Проверять каждую правку в браузере, а не по отчету агента. Уверенное объяснение агента не равно корректному результату.
- Проводить ревизию накопленных правок: убирать дубли и подходы, которые появились временно.
- Вести короткий список принятых решений: что выбрано и почему. Без него через месяц никто не помнит, зачем все устроено именно так.
Минимальный набор правил для агента выглядит так:
# Правила для агента
- одно изменение за раз, без смежных правок;
- новая зависимость только после явного подтверждения;
- после каждой правки: что изменено и где это проверить.
Что поручать агенту, а что оставлять человеку
| Агент ускоряет | Человек решает |
|---|---|
| Код по заданной структуре | Карта сайта и структура страниц |
| Рутинные правки и верстка состояний | Какие блоки нужны, а какие - лишние |
| Поиск багов по логам и симптомам | Архитектура, зависимости, точки роста |
| Черновики текстов по фактам компании | Факты, отличия, аргументы для клиента |
Частые вопросы
Ревизия уже собранного сайта
Если сайт уже оброс правками, разгребать начинают не с новой функции, а с карты фактического состояния: какие страницы и функции есть, что из них реально используется, что дублируется. Затем убирают дубли и мертвый код, проверяют границы модулей и фиксируют список решений. Подробно про механику кодового дрейфа и порядок ревизии - отдельная статья: Код AI-сборки расползается от правки к правке.
Архитектура - это список принятых решений, а не объем кода. Агент пишет код быстрее человека, но решения за него принимать некому. Кто фиксирует решения, тот и контролирует сайт. Про проверку решения до запуска и цену переделок - отдельная статья: Сайт своими руками с помощью AI.
