Визуальный дрейф в агентной разработке: почему интерфейс рассыпается от правки к правке
Визуальным дрейфом в этой статье называется постепенное расхождение интерфейса с принятыми визуальными правилами проекта при последовательных изменениях. Агентная разработка его ускоряет: больше локальных правок за единицу времени, меньше внимания к ранее принятым решениям, повторное создание существующих элементов. Лечится это не разовыми указаниями вида "сделай красиво", а постоянными правилами в репозитории, ограничением пространства решений и визуальной проверкой после каждой итерации.
Что такое визуальный дрейф
Рабочее определение такое: визуальный дрейф - это наблюдаемое расхождение интерфейса с визуальными правилами проекта, накопленное серией изменений. Деградация дизайн-системы - смежное явление, но не то же самое: она может быть причиной дрейфа, а может развиваться параллельно, когда саму систему правят без порядка. Дрейф прежде всего заметен в интерфейсе, деградация дизайн-системы - в ее структуре и реализации.
Проблема существовала и до агентов. Ручная разработка давала тот же эффект медленнее: один разработчик ставит одни отступы, второй - близкие, но другие, третий добавляет "почти такой же" синий. Агентная разработка меняет масштаб: правок больше, каждая по отдельности выглядит разумно, сумма дает интерфейс, собранный будто из разных проектов.
Почему агентная разработка его ускоряет
Агент оптимизирует выполнение поставленной задачи в пределах доступного контекста и заданных ограничений. Если правила дизайн-системы не описаны явно, а переиспользование компонентов не контролируется, локально подходящее решение может оказаться несовместимым с остальным интерфейсом.
Современный агент умеет читать файлы, искать компоненты и запускать браузер. Дело не в том, что он принципиально не способен увидеть систему. Дело в том, что по умолчанию его цель - закрыть текущую задачу, а не сохранить целостность всего интерфейса. Четыре следствия:
- темп выше: десятки локальных изменений там, где раньше было несколько;
- контекст ограничен задачей: соседние экраны и история визуальных решений вне фокуса;
- переиспользование не гарантировано: проще создать рядом похожий фрагмент, чем найти и расширить существующий компонент;
- проверка идет по сборке и тестам, а не по пикселям, если визуальную проверку не требовать отдельно.
Как дрейф проявляется в интерфейсе
Типовые симптомы, заметные без инструментов:
- типографика: заголовки одного уровня с разным кеглем и интерлиньяжем в соседних блоках;
- отступы: рядом живут значения вне утвержденной шкалы проекта;
- цвет: плодятся близкие оттенки серого и синего вместо утвержденных;
- радиусы и тени: в одном окне соседствуют несколько близких вариантов;
- кнопки и поля: одинаковые по смыслу элементы с разной высотой и внутренними отступами на соседних экранах.
Уточнение: несоответствие шагу 8 px само по себе не признак ошибки. У проекта может быть своя шкала. Признак дрейфа - появление значений вне утвержденной шкалы проекта, какой бы она ни была.
Как закрепить дизайн-систему в контексте агента
Разовые указания в диалоге не обеспечивают постоянства правил. Для этого ограничения дизайн-системы фиксируют в инструкциях проекта: например, AGENTS.md для инструментов, поддерживающих этот формат, или CLAUDE.md для Claude Code. Важно, чтобы используемый агент действительно загружал эти инструкции при работе с репозиторием.
Минимальный состав такого файла для борьбы с дрейфом:
- где лежат токены и какие файлы их определяют;
- какие компоненты переиспользовать и где их искать;
- какие библиотеки и подходы к стилизации приняты, что запрещено (например, инлайн-стили для системных значений);
- какие файлы нельзя менять без необходимости;
- как проверять визуальный результат (скриншот, превью, соседние экраны);
- что делать, если подходящего компонента нет: сначала расширить систему, потом использовать в месте правки.
Дизайн-токены становятся единственным источником утвержденных визуальных значений: цветов, типографики, шкалы отступов, радиусов и теней. Уточнение: запрет касается системных значений, а не всех px вообще. Технические величины вроде толщины границы в 1 px или сдвиги при позиционировании токенами быть не обязаны, их выносят из-под правила явно, чтобы запрет оставался проверяемым.
Пример правила:
/* разрешено: системные значения из токенов */
.card {
padding: var(--spacing-16);
color: var(--color-text-secondary);
border-radius: var(--radius-md);
}
/* запрещено: системное значение литералом */
.card {
color: #4b5563;
}
Второе правило того же файла: новые UI-элементы собираются из существующих компонентов, копирование разметки с точечными правками запрещено.
| Ситуация | Решение без закрепленных правил | Решение с инструкциями и токенами |
|---|---|---|
| Нужен отступ | Значение по контексту задачи | Использование подходящего токена из утвержденной шкалы |
| Нужен цвет | Подобранный hex | Токен из темы |
| Нужна кнопка | Скопированная разметка с правками | Переиспользование компонента, при отсутствии - сначала расширение компонента |
| Результат | Сборка прошла, задача закрыта | Скриншот приложен, соседние экраны проверены |
Как контролировать изменения
Инструкции задают правила, но сами по себе не гарантируют их соблюдение. Для системных значений полезно добавить автоматические проверки: например, Stylelint с ограничением допустимых значений через declaration-property-value-allowed-list или пользовательские правила под токены проекта. Сами по себе такие проверки допустимые токены не знают, их задает конфигурация. Визуальные тесты решают другую задачу - обнаруживают изменения внешнего вида, которые не обязательно нарушают CSS-правила. Инструменты таких проверок описаны в статье Визуальные регрессионные тесты: инструменты для контроля интерфейса.
Порядок приемки такой:
- Сравнение одного и того же состояния интерфейса при одинаковом viewport, содержимом и состоянии компонентов: скриншот до и после либо ссылка на превью. Без такого сравнения правка считается незавершенной.
- Проверка соседних экранов: правка одного блока не должна менять соседние.
- Для растущих проектов - визуальные регрессионные тесты. Для небольших хватает скриншотов и короткого чек-листа: только токены для системных значений, нет новых цветов и шрифтов, компонент переиспользован, скриншот приложен.
Чего делать не стоит: просить "сделай в едином стиле" без ссылки на токены и компоненты, давать длинные серии правок без промежуточной фиксации, лечить накопленный дрейф редизайном вместо заморозки значений и чистки дубликатов.
