Главная / Блог / Визуальный дрейф в агентной разработке

Визуальный дрейф в агентной разработке: почему интерфейс рассыпается от правки к правке

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

Что такое визуальный дрейф

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

Проблема существовала и до агентов. Ручная разработка давала тот же эффект медленнее: один разработчик ставит одни отступы, второй - близкие, но другие, третий добавляет "почти такой же" синий. Агентная разработка меняет масштаб: правок больше, каждая по отдельности выглядит разумно, сумма дает интерфейс, собранный будто из разных проектов.

Почему агентная разработка его ускоряет

Агент оптимизирует выполнение поставленной задачи в пределах доступного контекста и заданных ограничений. Если правила дизайн-системы не описаны явно, а переиспользование компонентов не контролируется, локально подходящее решение может оказаться несовместимым с остальным интерфейсом.

Современный агент умеет читать файлы, искать компоненты и запускать браузер. Дело не в том, что он принципиально не способен увидеть систему. Дело в том, что по умолчанию его цель - закрыть текущую задачу, а не сохранить целостность всего интерфейса. Четыре следствия:

  • темп выше: десятки локальных изменений там, где раньше было несколько;
  • контекст ограничен задачей: соседние экраны и история визуальных решений вне фокуса;
  • переиспользование не гарантировано: проще создать рядом похожий фрагмент, чем найти и расширить существующий компонент;
  • проверка идет по сборке и тестам, а не по пикселям, если визуальную проверку не требовать отдельно.

Как дрейф проявляется в интерфейсе

Типовые симптомы, заметные без инструментов:

  • типографика: заголовки одного уровня с разным кеглем и интерлиньяжем в соседних блоках;
  • отступы: рядом живут значения вне утвержденной шкалы проекта;
  • цвет: плодятся близкие оттенки серого и синего вместо утвержденных;
  • радиусы и тени: в одном окне соседствуют несколько близких вариантов;
  • кнопки и поля: одинаковые по смыслу элементы с разной высотой и внутренними отступами на соседних экранах.

Уточнение: несоответствие шагу 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-правила. Инструменты таких проверок описаны в статье Визуальные регрессионные тесты: инструменты для контроля интерфейса.

Порядок приемки такой:

  1. Сравнение одного и того же состояния интерфейса при одинаковом viewport, содержимом и состоянии компонентов: скриншот до и после либо ссылка на превью. Без такого сравнения правка считается незавершенной.
  2. Проверка соседних экранов: правка одного блока не должна менять соседние.
  3. Для растущих проектов - визуальные регрессионные тесты. Для небольших хватает скриншотов и короткого чек-листа: только токены для системных значений, нет новых цветов и шрифтов, компонент переиспользован, скриншот приложен.

Чего делать не стоит: просить "сделай в едином стиле" без ссылки на токены и компоненты, давать длинные серии правок без промежуточной фиксации, лечить накопленный дрейф редизайном вместо заморозки значений и чистки дубликатов.

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

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

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

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

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

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

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

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

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

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