Дозвіл дизайнерам відправляти компоненти безпосередньо у продакшн за допомогою AI-агентів
Як команда веб-розробників поклала край циклу «створити двічі»: дизайнери пишуть у бібліотеці для продакшну разом з агентами, інженери переглядають контракт, і тиждень роботи перетворюється на годину.
Джерела: Design engineering at Bolt: shipping components with AI agents
Публічна веб-платформа компанії з послуг таксі досягає десятків мільйонів користувачів щороку у понад п’ятдесяти ринках. Вона ґрунтується на спільній системі дизайну, яка містить понад сто десять елементів інтерфейсу. Команда фронт-енду змінила спосіб створення цих елементів: за допомогою штучних інтелектуальних агентів для програмування дизайнери тепер безпосередньо вставляють готовий код у бібліотеку для продакшну, і час доставки звичайних елементів скоротився з приблизно тижня до приблизно години. Цікавим є не швидкість, а те, що команда видала для досягнення цього та що вирішила зберегти.
Прогалина, яку не може заповнити файл дизайну
Автоматичне формування макету, стани наведення курсора, порядок фокусування та напрямок тексту — усе це можна розмістити в одному файлі Figma. Однак не кожна ситуація, з якою мусить впоратися браузер, піддається такому опису. Раніше інженери самостійно заповнювали всі прогалини: розробляли API компонентів, моделі клавіатури та те, що оголошує скрін-читер. Ніхто не фіксував, які рішення тихо передавалися від дизайнера до інженера протягом цього процесу.
Інструменти для кодування значно скорочують обсяг цієї роботи з перекладу. Тепер дизайнер, який працює разом із таким інструментом, може створити компонент, який дійсно працює, що залишає інші завдання для всіх інших: перевіряти цей компонент замість того, щоб писати його заново.
Як один і той самий компонент було створено двічі
Дизайнери в команді ніколи не обмежувалися лише Figma, хоча й починають свою роботу там із дослідження, створення токенів та визначення станів, необхідних компоненту. Наступним кроком не було передача завдання іншій команді. Вони відкрили агента для кодування та створили компонент у внутрішньому Storybook, де кожен стан відображається окремо. Агент створив версію компонента, дизайнери перевірили її у різних темах, ширинах та напрямках тексту, описали те, що було не так, і агент вніс зміни.
Результатом став справжній компонент, а не його зображення. Він компілювався, реагував у справжньому браузері, а його стани можна було переходити між собою кліком.
Потім робота припинилась. Компонент залишився у тому внутрішньому Storybook із власними правилами, тоді як продакшн-сайт будувався з абсолютно іншої бібліотеки. У результаті з’явилися два Storybooks — кожен з яких був джерелом інформації, — пов’язані лише через спеціальний тикет.
Два джерела інформації починають відхилятися одне від одного. Токен пробілу змінюється в одному місці, але не в іншому. Режим темного кольору чи написання з правого на ліве існує лише з одного боку. Дизайнери вже вирішили, чим відрізняється ефект наведення курсору від фокусу клавіатури, або як слід розгортати довгу німецьку назву, тоді як інженери працюють за замовленням, складеним ще до того, як були проведені ці перевірки. Дві „чесні“ копії одного компонента поступово перетворюються на дві різні речі.
Тож інженери взяли це замовлення та знову створили компонент у бібліотеці для продакшну, керуючись письмовим описом того, що вже існувало та працювало. На дошці проєкту обидва варіанти виглядають як звичайна робота, і нічого підозрілого не видно.
Це друге створення здавалося частиною ретельної перевірки, але це не було так. Дизайнери вже мали актуальну версію, а інженери переписали її, щоб вона могла знаходитися у бібліотеці, яку насправді використовує продакшн-сайт. Виникнення відхилень було передбачуваним наслідком існування двох Storybooks. Це була структурна особливість такої налаштування, а не прояв недисциплінованості.
Використання певної посади чи нового інструменту ніколи не було мотивом. Процес роботи все ще будувався навколо переданої зображення, а дизайнери вже давно покинули цей світ. Переписування марнувало зусилля, два Storybooks гарантували відхилення, а весь життєвий цикл передбачав, що реалізація — це повільний етап. З використанням агентів введення даних стало швидким, тож затримка перемістилася на суміжні етапи та на процес перестроювання посередині.
У новій схемі два кольору янтарного кольору зі старої діаграми, тобто один і той самий компонент, написаний двічі, об’єднуються в один. Дизайнери пишуть його лише один раз у бібліотеці для виробництва. Процес перевірки стає більш масштабним – двоє інженерів разом із дизайнерами підтверджують вигляд елементів, тоді як раніше це робив лише один інженер, вручну переглядаючи зміни. Кількість людей, які беруть участь у перевірці, зростає повільніше, ніж скорочується кількість етапів реалізації, і саме ця різниця є економією часу. Для стандартних компонентів, які відповідають системі дизайну, це означає економію кількох годин, а не цілого спринту.
Зображення, надане дизайнерами, залишає інженерам лише одне завдання — відтворити його. Готовий код не потребує відтворення, тож залишається відкритим питання про те, чи є компонент правильним. Чи добре його API інтегрується з рештою бібліотеки? Чи підходять його семантики для скринь-читача? Чи функціонує він на кожному точці переривання та у обох напрямках тексту? Саме це питання завжди було найважливішим, але раніше воно ставилося останнім, після того як вже були витрачені кошти на написання коду. Тепер воно стоїть на першому місці, і той самий рівень якості коштує дешевше, оскільки перевірка стосується того, що вже існує. Що насправді змінилося
Інженерія дизайну тут означає спільну власність на один продукт. Дизайнери можуть додавати компоненти до репозиторію, а інженери відповідають за API та архітектуру. Замість передачі опису між командами обидві групи працюють безпосередньо над самим компонентом.
Для цієї зміни не потрібні нові інструменти чи титули — лише доступ до правильної бази коду. Дизайнери тепер працюють безпосередньо в бібліотеці компонентів, яка живить публічні сторінки, використовуючи цикл agent-and-Storybook, який вони вже знали. Те, над чим вони працюють, саме те, що потім оприлюднюється.
Це можливо лише за умови, що результати роботи агента можна безпечно переглядати, тому команда описала свої вимоги у файлі AGENTS.md. Інструкції в цьому файлі встановлюють стандарти якості бібліотеки:
- Використовувати існуючі токени.
- Створювати на основі доступних примітивів.
- Писати описи для кожної значущої варіації.
- Не торкатися непов’язаного коду.
Цей файл також визначає межі, розділяючи публічні елементи від внутрішніх та від всього, що має знаходитися поза бібліотекою компонентів.
Правила існують для захисту бібліотеки як продукту. Публічні API залишаються такими, якими вони є, якщо тільки зміни не робляться навмисно з метою порушення стабільності; у таких випадках перевагу мають усталені конвенції над новими підходами, а кожна зміна має бути достатньо незначною для об’єктивного аналізу. Метою є не просто код, який працює, а код, який залишається передбачуваним для кожної команди, яка від нього залежить.
Супутня навичка визначає порядок роботи. Перш ніж почати працювати з фреймом у Figma, спеціаліст перевіряє, чи вже існує відповідний компонент чи спосіб взаємодії, вирішує, чи він має бути публічним чи внутрішнім, потім створює сценарій роботи та перевіряє результат. Фрейм виступає у ролі візуальної специфікації; це не джерело значень пікселів для копіювання та не привід для створення нового API.
Завдяки інструкціям, правилам та послідовності дій спеціалісти отримують достатньо контексту та структури для створення компонентів, які підходять до складу бібліотеки.
Модель перегляду
Дизайнери створюють запит на зміни. Запускаються інструменти CI та Chromatic, після чого дизайнери схвалюють візуальні зміни. Потім два інженери перевіряють API, доступність та архітектуру, і дизайнери об’єднують зміни.
Перегляд поділяється за тим, хто може оцінювати що:
- Дизайнери відповідають за візуальну коректність, токени, анімацію та стани; усе це схвалюється під час візуального перегляду.
- Два інженери відповідають за API компонентів, семантику доступності, архітектуру та охоплення тестами.
З практичних причин візуальний перегляд здійснюється дизайнерами, а не інженерами. Вони схвалюють зміни безпосередньо там, де вони з’являються, без необхідності читати відмінності та без того, щоб інженери дивилися на скріншот замість них.
До та після
Старий процес створення компонентів призводив до формування працездатного компонента в внутрішньому Storybook, заявки на розробку та потім ще одного компонента у бібліотеці для використання в продакшені. Візуальні елементи схвалювалися на основі пам’яті або шляхом перегляду скріншотів інженерами.
У новому процесі дизайнери працюють у тій самій бібліотеці, з якої будується живий сайт, схвалюють елементи інтерфейсу в Chromatic та залишають двох інженерів для перевірки результату. Якщо компонент вже підходить системі, перехід від функціонального прототипу до остаточної версії займає години, причому весь цей час витрачається на перевірку.
Витрати, які прийняла команда
Основний ризик — це звичайний ризик. Дизайнери у поєднанні з агентом можуть створити щось, що виглядає правильно, але насправді не є таким: API, яке конфліктує з рештою бібліотеки, елемент керування без доступного імені чи сценарій, який використовує лише простий шлях. Права на запис означають, що такий компонент можна фактично об’єднати. Тому контракт належить двом інженерам, а візуальний елемент — дизайнеру, щоб ніхто не вдавав, ніби переглядає все.
Сам механізм об’єднання не враховує поняття „два інженери“. GitHub рахує два схвалення від будь-кого з правами на запис, тож таке поєднання є конвенцією моделі перегляду. Якщо ця конвенція порушується, ризик знову з’являється.
Перегляд навмисно є вузьким місцем. Якщо ці два рецензенти працюють повільно, витрати залишаються, а не зникають.
Дизайнери також повинні запустити репозиторій локально. Процес налаштування є складним, і єдиним рішенням наразі є посібник з участі та одна сесія співпраці.
Нарешті, цей підхід призначений для компонентів, які підходять до системи. Щоб агент міг їх імітувати, хтось повинен спочатку додати до бібліотеки справді новий шаблон. Компоненти зі складним станом, перериваним рухом чи незвичайною семантикою все ще потребують розробників, які їх створюють, а не просто перевіряють пізніше.
Що можна застосувати до інших команд
- Створюйте кожен UI-компонент лише один раз. Коли дизайнери можуть створити функціональний код, який підходить до системи, наступним кроком має бути перегляд.
- Використовуйте єдину спільну бібліотеку компонентів. Паралельне використання Storybooks та передача замовлень призводить до розбіжностей, тому все, що створюють дизайнери, має потрапляти до фінальної версії продукту.