Главная / Статьи

Как позволить дизайнерам сразу отправлять компоненты в производство с помощью ИИ-агентов

Как команда веб-разработки прекратила цикл «создай дважды»: дизайнеры пишут код в производственную библиотеку с помощью ИИ-агентов, инженеры проверяют код, и неделя работы превращается в один час.

Издатель: REACTAPP.TOP7 мин чтения1674 слов

Источники: Design engineering at Bolt: shipping components with AI agents

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

Пробел, который дизайнерский файл не может преодолеть

Автоматическое форматирование, состояния наведения, порядок фокусировки и направление текста — всё это помещается в один файл Figma. Однако не все ситуации, с которыми должен справляться браузер, учитываются в нём. Раньше инженеры сами заполняли пробелы: разрабатывали API компонентов, модели клавиатуры и то, что озвучивает скрин-ридер. Никто не фиксировал, какие решения тихо передавались от дизайнера к инженеру на протяжении работы над проектом.

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

Как один и тот же компонент был создан дважды

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

Результатом стал настоящий компонент, а не его изображение. Он компилировался, реагировал в реальном браузере, и его состояния можно было переключать по нажатию.

Затем работа прекратилась. Компонент оставался в этом внутреннем Storybook с собственными правилами, в то время как производственный сайт создавался с использованием совершенно другой библиотеки. В итоге появились два Storybook, каждый из которых был источником истинной информации, связанные между собой лишь через специальный тикет.

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

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

Вторая версия казалась частью процедуры проверки, но на самом деле это не так. У дизайнеров уже была рабочая версия, а инженеры переписали её, чтобы она могла храниться в библиотеке, которую фактически использует производственный сайт. Различия между версиями были неизбежным следствием существования двух проектов Storybooks. Это было структурным свойством данной схемы, а не проявлением недисциплинированности.

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

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

От воспроизведения к оценке

Изображение, переданное дизайнерами, оставляет инженерам лишь одну задачу — воспроизвести его. Готовый код не требует воспроизведения, поэтому остается открытым вопрос: правильен ли этот компонент? Хорошо ли его API сочетается с остальной библиотекой? Подходят ли его семантические особенности для скрин-ридеров? Сохраняет ли он работоспособность на всех точках прерывания и в обоих направлениях текста? Именно этот вопрос всегда был важным, но раньше он рассматривался в последнюю очередь, после того как уже были потрачены средства на написание кода. Теперь он стоит на первом месте, и тот же стандарт качества обходится дешевле, поскольку проверка касается уже существующего продукта.

Что на самом деле изменилось

Под проектированием в данном контексте подразумевается совместная ответственность за один продукт. Дизайнеры могут добавлять компоненты в репозиторий, в то время как инженеры отвечают за API и архитектуру. Вместо передачи описаний между командами обе группы работают непосредственно над самим компонентом.

Для этой замены не требовались ни новые инструменты, ни новые названия — достаточно было доступа к правильной базе кода. Теперь дизайнеры работают непосредственно в библиотеке компонентов, обеспечивающей работу публичных страниц, используя уже знакомый им цикл agent-and-Storybook. Именно то, над чем они работают, позже попадает в продакшн.

Это сработает только в том случае, если результаты работы агента можно безопасно проверять, поэтому команда описала свои ожидания в файле AGENTS.md. Инструкции в этом файле устанавливают стандарты качества библиотеки:

  • Используйте существующие токены.
  • Разрабатывайте на основе доступных примитивов.
  • Пишите описания для каждого значимого варианта.
  • Не трогайте не связанный код.

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

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

Сопутствующий набор навыков определяет порядок работы. Прежде чем приступить к работе с шаблоном из Figma, специалист проверяет, существует ли уже соответствующий компонент или интеракция, решает, должен ли он быть общедоступным или внутренним, затем создаёт структуру проекта и проверяет результат. Шаблон служит визуальной спецификацией; он не является источником значений пикселей для копирования и не служит оправданием для создания нового API.

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

Модель ревью

Дизайнеры создают запрос на интеграцию. Запускаются инструменты CI и Chromatic, после чего дизайнеры утверждают внесенные визуальные изменения. Затем два инженера проверяют API, доступность и архитектуру, после чего дизайнеры сливают изменения.

Процесс ревью разделен по тому, кто может оценивать что:

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

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

До и после

Старый процесс создавал рабочий компонент во внутреннем Storybook, соответствующий заявку, а затем второй компонент для библиотеки, используемой в продакшене. Визуальные элементы утверждались на основе памяти или после просмотра скриншота инженерами.

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

Расходы, которые приняла команда

Основной риск — это самый очевидный. Дизайнеры в сотрудничестве с агентом могут создать что-то, что на первый взгляд кажется правильным, но на деле таковым не является: API, конфликтующее с остальной частью библиотеки, элемент управления без доступного имени или сценарий, в котором используется только простой путь решения задачи. Наличие прав на запись означает, что такой компонент действительно можно объединить с остальным кодом. По этой причине контракт относится к двум инженерам, а визуальные элементы — к дизайнеру, чтобы никто не притворялся, что проверяет всё.

Сам механизм объединения кода не предусматривает участия «двух инженеров». GitHub считает два одобрения от кого угодно с правами на запись, поэтому такое сотрудничество является частью конвенций модели рецензирования. Если эта конвенция нарушается, риск возвращается.

Рецензирование намеренно является узким местом. Если эти два рецензента работают медленно, потери не исчезают, а лишь перемещаются в другое место.

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

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

Что применимо и к другим командам

  • Создавайте каждый UI-компонент только один раз. Когда дизайнеры могут сгенерировать рабочий код, соответствующий системе, следующим шагом должен стать его аудит.
  • Используйте единую общую библиотеку компонентов. Параллельное использование Storybooks и передача задач приводят к расхождениям, поэтому то, что создают дизайнеры, должно идти в продакшн.
  • Установите ограничители там, где агенты могут ими руководствоваться. Письменные инструкции и стандарты направляют агентов к соответствующим компонентам и отвращают их от случайных изменений, приводящих к сбоям, или от нестандартных паттернов.
  • Оставьте техническое суждение для тех ситуаций, где оно действительно важно. Новые паттерны, сложные состояния и пользовательские решения по обеспечению доступности по-прежнему требуют технических навыков, в то время как при рутинной работе больше пользы приносит проверка спецификаций компонента, чем переписывание дизайна.