Umożliwienie projektantom dostarczania komponentów bezpośrednio do produkcji za pomocą agentów AI
Jak zespół webowy zakończył cykl „buduj dwa razy”: projektanci piszą w bibliotece produkcyjnej razem z agentami, inżynierowie sprawdzają umowę, a tydzień pracy zamienia się w godzinę.
Źródła: Design engineering at Bolt: shipping components with AI agents
Publiczna platforma internetowa firmy oferującej usługi transportu dociera co roku do dziesiątek milionów osób na ponad pięćdziesięciu rynkach. Opiera się ona na wspólnym systemie projektowym zawierającym ponad sto dziesięć komponentów interfejsu użytkownika. Zespół odpowiedzialny za stronę klienta zmienił sposób tworzenia tych komponentów: projektanci teraz dzięki agentom kodującym opartym na sztucznej inteligencji dostarczają gotowy kod bezpośrednio do biblioteki produkcyjnej, a czas dostarczania standardowych komponentów skrócił się z około tygodnia do około godziny. Interesującym elementem nie jest szybkość, lecz to, co zespół usunął, aby do tego dojść, oraz to, co postanowił zachować.
Luka, której plik projektowy nie może zamknąć
Automatyczne układanie, stany nadkładania kursora, kolejność fokusu oraz kierunek tekstu – wszystko to mieści się w pliku Figma. Nie dotyczy to jednak każdej sytuacji, z którą musi sobie poradzić przeglądarka. Inżynierowie tradycyjnie zajmowali się resztą: API komponentu, modelem klawiatury oraz tym, co odczytuje czytnik ekranu. Nikt nie rejestrował, które decyzje po cichu przechodziły z rąk projektanta do inżyniera w trakcie pracy.
Agenty kodujące zmniejszają znaczną część tej pracy tłumaczeniowej. Projektant pracujący razem z agentem może teraz stworzyć komponent, który rzeczywiście działa, co pozostawia innym zupełnie inne zadanie: przeglądanie komponentu zamiast pisania go ponownie.
Jak ten sam komponent został stworzony dwa razy
Dizajnerzy w zespole nigdy nie ograniczali się tylko do Figma, chociaż nadal zaczynają tam pracę od eksploracji, tokenów oraz stanów, których potrzebuje komponent. Kolejnym krokiem nie było przekazanie zadania innym osobom – otworzyli narzędzie do programowania i stworzyli komponent wewnątrz wewnętrznego Storybook, gdzie każdy stan jest renderowany oddzielnie. Narzędzie to wygenerowało wersję komponentu, a dizajnerzy sprawdzili ją pod różnymi tematami, szerokościami i kierunkami tekstu, opisali to, co wyglądało niepoprawnie, a narzędzie dokonało odpowiednich poprawek.
Rezultatem była prawdziwa implementacja komponentu, a nie tylko jego obraz. Komponent ten kompilował się, reagował w rzeczywistym przeglądarce, a jego stany można było przechodzić klikając.
Następnie praca została wstrzymana. Komponent pozostał w tym wewnętrznym Storybook z własnymi konwencjami, podczas gdy strona produkcyjna była budowana przy użyciu zupełnie innej biblioteki. Skutkiem tego były dwa Storybooki, z których każde stanowiło źródło prawdy, połączone jedynie przez numer zgłoszenia.
Dwie źródła prawdy stopniowo się oddalają. Token odstępu zmienia się w jednym miejscu, a nie w drugim. Tryb ciemny lub z lewej na prawą istnieje tylko po jednej stronie. Projektanci już zdecydowali, w jaki sposób efekt hover różni się od skupienia klawiatury, lub jak długi niemiecki etykiet powinien się układać, podczas gdy inżynierowie pracują na podstawie zgłoszenia sporządzonego przed przeprowadzeniem tych sprawdzeń. Dwie wiernie odpowiadające sobie kopie jednego komponentu powoli przekształcają się w dwie różne rzeczy.
Dlatego inżynierowie wzięli to zgłoszenie i ponownie stworzyli komponent w bibliotece produkcyjnej, opierając się na pisemnym opisie czegoś, co już istniało i działało. Na tablicy projektu obie wersje wyglądają jak zwykła praca i nic nie wydaje się nietypowe.
To drugie tworzenie wydawało się elementem rutynowej weryfikacji, ale tak nie było. Projektanci mieli już aktywną wersję, a inżynierowie wpisali ją ponownie, aby mogła znajdować się w bibliotece używanej na stronie produkcyjnej. Rozbieżności były nieuniknionym skutkiem utrzymywania dwóch instancji Storybooks. Była to cecha strukturalna takiego ustawienia, a nie brak dyscypliny.
Przyjęcie nowego tytułu stanowiska czy narzędzia nigdy nie było motywacją. Proces nadal był zaprojektowany wokół przekazanego obrazu, a projektanci już dawno opuścili ten obszar. Ponowne wpisywanie danych było stratą czasu, dwie instancje Storybooks gwarantowały rozbieżności, a cały cykl życia zakładał, że implementacja jest wolnym etapem. Dzięki agentom wpisywanie danych stało się szybsze, więc opóźnienie przeniosło się na kolejne etapy oraz na ponowne tworzenie w środku procesu.
W nowym procesie dwa etapy w kolorze pomarańczowym z starego diagramu, te same komponenty napisane dwa razy, łączą się w jeden. Projektanci piszą je tylko raz, w bibliotece produkcyjnej. Proces sprawdzania staje się szerszy – dwóch inżynierów wraz z projektantami zatwierdzają elementy wizualne, podczas gdy wcześniej jeden inżynier ręcznie analizował różnice. Zwiększenie liczby osób sprawdzających jest mniejsze niż zmniejszenie się czasu implementacji, a ta różnica stanowi oszczędność. W przypadku rutynowych komponentów pasujących do systemu projektowego chodzi o kilka godzin, a nie o cały sprint.
Od reprodukcji do oceny
Zdjęcie przekazane przez projektantów pozostawia inżynierom jedno zadanie: jego odtworzenie. Kod w stanie działania nie wymaga żadnego odtwarzania, więc pozostaje otwarte pytanie, czy komponent jest poprawny. Czy jego API dobrze współpracuje z resztą biblioteki? Czy jego semantyka jest zrozumiała dla czytnika ekranu? Czy funkcjonuje poprawnie przy każdym punkcie przerwania i w obu kierunkach tekstu? To pytanie zawsze miało kluczowe znaczenie, ale wcześniej pojawiało się na końcu, po tym jak koszt pisania został już pokryty. Teraz jest na pierwszym miejscu, a ta sama norma jakości kosztuje mniej, ponieważ przegląd dotyczy czegoś, co już istnieje.
Co tak naprawdę się zmieniło
Inżynieria projektowa oznacza tutaj wspólne posiadanie jednego artefaktu. Projektanci mogą dostarczać komponenty do repozytorium, natomiast inżynierowie są odpowiedzialni za API i architekturę. Zamiast przekazywać opisy pomiędzy zespołami, obie grupy pracują bezpośrednio nad samym komponentem.
Zmiana ta nie wymagała żadnych nowych narzędzi ani tytułów, jedynie dostępu do właściwego kodu źródłowego. Projektanci teraz pracują bezpośrednio w bibliotece komponentów, która obsługuje strony publiczne, korzystając z już znanej im pętli agent-and-Storybook. To, nad czym dokonują iteracji, jest dokładnie tym, co trafia do użycia.
To działa tylko wtedy, gdy wyniki działania agenta można bezpiecznie przejrzeć, dlatego zespół zapisał swoje oczekiwania w pliku AGENTS.md. Zawarte tam instrukcje określają standardy jakości biblioteki:
- Wykorzystuj istniejące tokeny.
- Buduj na podstawie dostępnych elementów bazowych.
- Pisz opisy dla każdej istotnej wersji.
- Nie ingeruj w niepowiązany kod.
Plik ten określa również granice, oddzielając elementy publiczne od tych wewnętrznych oraz od wszystkiego, co powinno znajdować się poza biblioteką komponentów.
Zasady te istnieją po to, by chronić bibliotekę jako produkt. Publiczne API pozostają bez zmian, chyba że zmiana ta jest celowa, ustalone konwencje mają pierwszeństwo przed nowatorskimi rozwiązaniami, a każda zmiana jest na tyle mała, by można ją było łatwo przeanalizować. Celem nie jest tylko kod, który funkcjonuje – chodzi o kod, który pozostaje przewidywalny dla każdego zespołu, który od niego korzysta.
Towarzysząca temu umiejętność określa kolejność działań. Zanim agent rozpocznie pracę na ramie w Figma, sprawdza, czy dany komponent lub interakcja już istnieje, decyduje, czy powinien być publiczny, czy wewnętrzny, a następnie tworzy odpowiednią strukturę i weryfikuje wynik. Rama pełni rolę wizualnej specyfikacji – nie jest źródłem wartości pikseli do skopiowania ani wymówką do stworzenia nowego API.
Dzięki instrukcjom, wytycznym i określonej sekwencji działań agenci mają wystarczający kontekst i strukturę, by tworzyć komponenty, które pasują do biblioteki.
Model przeglądania
Projektanci otwierają prośbę o połączenie kodu. Uruchamiają się CI i Chromatic, a projektanci akceptują zmiany wizualne. Następnie dwaj inżynierowie sprawdzają API, dostępność i architekturę, po czym projektanci łączą zmiany.
Przeglądanie jest podzielone według tego, kto może oceniać co:
- Projektanci są odpowiedzialni za poprawność wizualną, tokeny, ruch i stany – wszystko to jest zatwierdzane podczas przeglądu wizualnego.
- Dwaj inżynierowie odpowiadają za API komponentu, semantykę dostępności, architekturę oraz zakres testów.
Przegląd wizualny odbywa się przy udziale projektantów, a nie inżynierów z praktycznego powodu. Akceptują oni zmianę dokładnie w miejscu, gdzie się pojawiła, bez konieczności czytania różnic i bez potrzeby, by inżynier przyglądał się zrzutowi ekranu w ich imieniu.
Przed i po
Stary proces tworzenia składników generował działający komponent w wewnętrznym Storybook, zgłoszenie oraz drugi komponent w bibliotece używanej do publikacji. Wizualne elementy były zatwierdzane na podstawie pamięci lub po przejrzeniu skrótu ekranu przez inżynierów.
W nowym procesie projektanci pracują w tej samej bibliotece, z której budowana jest strona online, zatwierdzają elementy w Chromatic i pozostawiają dwóch inżynierów do przejrzenia dokumentacji. Gdy komponent już pasuje do systemu, przechodzenie od działającego prototypu do połączonej zmiany trwa godziny, a cały czas ten jest przeznaczony na przeglądanie.
Koszty zaakceptowane przez zespół
Głównym ryzykiem jest to najprostsze. Projektanci współpracujący z agentem mogą stworzyć coś, co wygląda poprawnie, ale tak naprawdę nie jest: API, które koliduje z resztą biblioteki, element sterujący bez dostępnego nazwy lub rozwiązanie, które wykorzystuje tylko najłatwiejszą drogę. Prawo do edycji oznacza, że taki komponent może faktycznie zostać połączony. Z tego powodu umowa należy do dwóch inżynierów, a elementy wizualne do projektanta, aby nikt nie udawał, że sprawdza wszystko.
Sama brama łączenia nie określa „dwóch inżynierów”. GitHub liczy dwie zatwierdzenia od kogokolwiek, kto ma prawo do edycji, więc ta współpraca jest konwencją modelu przeglądania. Jeśli ta konwencja zostanie złamana, ryzyko powraca.
Przeglądanie jest teraz celowo wąskim gardłem. Jeśli ci dwaj recenzenci działają powoli, marnotrawstwo się przenosi, a nie znika.
Projektanci muszą również uruchomić repozytorium lokalnie. Trudności przy konfiguracji są rzeczywiste, a jedynym rozwiązaniem na razie jest przewodnik dotyczący wkładu oraz jedna sesja współpracy.
Ostatecznie ta ścieżka jest przeznaczona dla komponentów, które pasują do systemu. Zanim agent będzie mógł je naśladować, ktoś musi dodać do biblioteki zupełnie nowy wzorzec. Komponenty o złożonym stanie, ruchu podlegającym przerwaniu lub nietypowej semantyce wciąż wymagają pracy inżynierów przy ich tworzeniu, a nie tylko sprawdzania ich później.
Co można przenieść na inne zespoły
- Niech każdy komponent interfejsu jest tworzony tylko raz. Gdy projektanci potrafią stworzyć działający kod dostosowany do systemu, następnym krokiem powinna być ocena tego kodu.
- Utrzymuj jedną wspólną bibliotekę komponentów. Różne narzędzia takie jak Storybooks oraz przekazywanie zadań prowadzą do rozbieżności, dlatego to, co stworzą projektanci, powinno być tym, co trafia do użytku.
Literatura pokrewna
- Projektowanie systemu Agentic Checkout: upoważnienia delegowane, przestarzałe oferty, powtórzenia prób — Przewodnik po projektowaniu systemów opartych na agentach do dokonywania zakupów: wymagania, przestarzałe oferty, klucze idempotencji, które zawodzą, główny sprzedawca, ślady audytowe oraz przewodnik oceniania.
- Notatki praktyczne: Co nauczyłem się o wysyłaniu agenta AI do produkcji za pomocą usług Google — Szczegółowy przewodnik po Notatkach praktycznych: Co nauczyłem się o wysyłaniu agenta AI do produkcji za pomocą usług Google: umowy, sprawdzenia oraz miejsca na kod do wstawienia dla zespołów implementujących ten model.