Дызайнеры выпускаюць кампаненты адразу ў прадакшн з дапамогай AI-агентаў
Як вэб-каманда спыніла цыкл «рабі двойчы»: дызайнеры пішуць у прадакшн-бібліятэцы з агентамі, інжынеры правяраюць кантракт, і тыдзень працы ператвараецца ў гадзіну.
Крыніцы: Design engineering at Bolt: shipping components with AI agents
Публічная веб-платформа компаніі з арэнды автотаксі ў кожны год доходзіць да дзесяткаў мільйонаў чалавек у падметку пяцідзесятай краін. Яна стоіць на спяльной сістэме дызайну, якая складаецца з пад 110 элементаў інтэрфейсу. Команда, якая працуе над фронт-эндам, зменіла спосаб стварэння гэтых элементаў: дызайнеры цяпер за дапамогай AI-агентаў для напісання коду вводзяць готовы код працэйскім бібліятэкам, і час выдання элементаў зменіўся з апошней часу з адной недзелі на апошней часу — адну гадзіну. Цікавае не ў шыроце, а ў тым, што команда паспела адмахнуцца, каб досягнуць гэтага, і што яна выбрала залішыць.
Праслойка, якую файл дызайну не можа закрыць
Автамакетаванне, станы пад час наведэння курсора, парадак фокусу і напрамак тэксту — усё гэта можа быць ў файле 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 і перэдача заявок спрычыняюць розбіжнасці, таму все, што ствараюць дзяржаўнікі, павінна быць тым, што выдаецца.