Permettre aux designers d’envoyer directement des composants en production grâce à des agents IA
Comment une équipe web a mis fin au cycle « construis deux fois » : les designers écrivent dans la bibliothèque de production avec des agents, les ingénieurs examinent le contrat, et une semaine de travail se réduit à une heure.
Sources: Design engineering at Bolt: shipping components with AI agents
La plateforme web publique d’une entreprise de covoiturage atteint des dizaines de millions de personnes chaque année dans plus de cinquante marchés. Elle repose sur un système de conception partagé comprenant plus de cent dix composants UI. L’équipe front-end a modifié la manière dont ces composants sont créés : les designers transmettent désormais directement du code fonctionnel dans la bibliothèque de production avec l’aide d’agents de codage basés sur l’IA, et le temps nécessaire pour livrer des composants habituels est passé d’environ une semaine à environ une heure. Ce qui est intéressant, ce n’est pas la vitesse. C’est plutôt ce que l’équipe a supprimé pour y parvenir, et ce qu’elle a choisi de conserver.
L’écart que un fichier de conception ne peut combler
Le layout automatique, les états de survol, l’ordre de focus et la direction du texte trouvent tous leur place dans un fichier Figma. En revanche, toutes les situations auxquelles un navigateur doit faire face ne s’y intégrent pas. Traditionnellement, les ingénieurs comblaient cette lacune : l’API du composant, le modèle clavier et ce que lit un lecteur d’écran. Personne n’a jamais enregistré quelles décisions avaient été transmises discrètement du designer à l’ingénieur au fil du processus.
Les agents de codage réduisent fortement ce travail de traduction. Un designer travaillant en collaboration avec un tel agent peut désormais créer un composant qui fonctionne réellement, ce qui laisse une tâche différente pour tous les autres : examiner le composant plutôt que de le réécrire.
Comment le même composant a été construit deux fois
Les concepteurs de l’équipe n’ont jamais limité leur travail à Figma, bien qu’ils y commencent toujours par explorer les éléments, les tokens et les états nécessaires à un composant. La suite du processus n’a pas impliqué de transfert de responsabilités : ils ont ouvert un agent de codage et ont développé le composant à l’intérieur d’un Storybook interne, où chaque état s’affiche de manière isolée. Cet agent a généré une version du composant, que les concepteurs ont testée sous différents thèmes, largeurs et orientations de texte, en indiquant ce qui n’allait pas, ce qui a permis à l’agent de le modifier.
Le résultat était un véritable composant et non simplement une représentation visuelle de celui-ci. Il se compilait correctement, réagissait à un vrai navigateur, et ses états pouvaient être parcourus en cliquant dessus.
Puis les travaux se sont arrêtés. Le composant est resté dans ce Storybook interne, avec ses propres conventions, tandis que le site de production était construit à partir d’une bibliothèque complètement différente. La conséquence a été l’existence de deux Storybooks, chacun constituant une source d’information fiable, reliés uniquement par un ticket de travail.
Deux sources de vérité s’éloignent l’une de l’autre. Un token d’espacement change en un endroit mais pas dans un autre. Un mode sombre ou une disposition de droite à gauche n’existe que d’un côté. Les designers ont déjà décidé en quoi le survol diffère du focus clavier, ou comment un long label allemand doit être ajusté, tandis que les ingénieurs travaillent à partir d’une demande rédigée avant que ces vérifications ne soient effectuées. Deux versions fidèles d’un même composant se transforment progressivement en deux éléments distincts.
Ainsi, les ingénieurs ont repris cette demande et reconstruit le composant au sein de la bibliothèque de production, en se basant sur une description écrite de quelque chose qui existait déjà et fonctionnait. Sur le tableau de projet, les deux versions ressemblent à des tâches ordinaires, et rien ne semble anormal.
Ce deuxième processus de création semblait être une mesure de prudence, mais ce n’était pas le cas. Les concepteurs disposaient déjà d’une version en cours de développement, et les ingénieurs l’ont recopiée afin qu’elle puisse être intégrée à la bibliothèque utilisée réellement par le site de production. La divergence était inévitable lorsqu’on conservait deux versions Storybooks ; c’était une caractéristique intrinsèque de cette configuration, et non un manque de discipline.
L’adoption d’un nouveau titre de poste ou d’un nouvel outil n’a jamais été le motif. Le flux de travail était toujours conçu en fonction d’une image préexistante, alors que les concepteurs avaient depuis longtemps quitté ce domaine. Recopier manuellement des éléments était une perte de temps, deux versions Storybooks garantissaient la divergence, et tout le cycle de vie partait du principe que l’implémentation était l’étape la plus lente. Avec les agents, la saisie devenait rapide, ce qui déplaçait le retard vers les étapes suivantes ainsi que vers la reconstruction intermédiaire.
Dans le nouveau flux, les deux étapes couleur ambre de l’ancien diagramme, représentant le même composant écrit deux fois, se fusionnent en une seule. Les concepteurs le définissent une seule fois, dans la bibliothèque de production. Le processus d’examen s’élargit, avec deux ingénieurs en plus des concepteurs qui valident les visuels, alors qu’auparavant un seul ingénieur examinait manuellement les différences. L’augmentation du temps d’examen est inférieure à la réduction du temps de mise en œuvre, et c’est cette différence qui représente l’économie réalisée. Pour les composants courants correspondant au système de conception, cela représente des heures plutôt qu’un sprint.
De la reproduction à l’évaluation
Une image fournie par les concepteurs ne laisse aux ingénieurs qu’une tâche : la reproduire. Un code fonctionnel ne nécessite rien à reproduire, ce qui soulève la question de savoir si le composant est correct. Son API s’intègre-t-elle bien au reste de la bibliothèque ? Ses sémantiques fonctionnent-elles avec un lecteur d’écran ? Fonctionne-t-il à tous les points de rupture et dans les deux sens de lecture ? C’était toujours la question qui comptait, mais elle venait en dernier, après que le travail de codage avait déjà été effectué. Aujourd’hui, elle passe en premier, et le même niveau de qualité coûte moins car l’évaluation porte sur quelque chose qui existe déjà.
Qu’est-ce qui a vraiment changé
Ici, l’ingénierie de conception signifie une propriété partagée d’un même artefact. Les concepteurs peuvent déposer des composants dans le répertoire de stockage, tandis que les ingénieurs sont responsables de l’API et de l’architecture. Au lieu de transmettre une description entre les équipes, les deux groupes travaillent directement sur le composant lui-même.
Cette évolution ne nécessitait ni nouvel outil ni nouveau titre, seulement l’accès au bon codebase. Les concepteurs travaillent désormais directement dans la bibliothèque de composants qui alimente les pages publiques, en utilisant le cycle agent-Storybook qu’ils connaissaient déjà. Ce sur quoi ils itèrent est exactement ce qui est mis en ligne.
Cela ne fonctionne que si les résultats générés par l’agent sont sûrs à examiner, c’est pourquoi l’équipe a consigné ses attentes dans un fichier AGENTS.md. Les instructions contenues dans ce fichier fixent les critères de qualité de la bibliothèque :
- Réutiliser les tokens existants.
- Construire à partir de primitives accessibles.
- Rédiger des scénarios pour chaque variante significative.
- Ne pas modifier de code non pertinent.
Ce fichier définit également des limites, séparant les éléments publics de ceux internes, ainsi que tout ce qui devrait rester en dehors de la bibliothèque de composants.
Ces règles existent pour protéger la bibliothèque en tant que produit. Les API publiques restent telles quelles, à moins qu’une modification radicale ne soit délibérée, à moins que des conventions établies ne l’emportent sur de nouvelles approches, et à condition que chaque modification reste suffisamment modeste pour être examinée avec assurance. L’objectif n’est pas seulement du code qui fonctionne, mais du code qui reste prévisible pour toutes les équipes qui en dépendent.
Une compétence complémentaire définit l’ordre des tâches. Avant de partir d’un cadre Figma, un agent vérifie si le composant ou l’interaction existe déjà, décide s’il doit être public ou interne, puis construit le scénario et vérifie le résultat. Le cadre sert de spécification visuelle ; il ne constitue ni une source de valeurs de pixels à copier, ni une excuse pour inventer une API.
Avec ces instructions, ces garde-fous et cette séquence, les agents disposent du contexte et de la structure nécessaires pour créer des composants qui conviennent à la bibliothèque.
Le modèle d’évaluation
Les designers ouvrent une demande de fusion. CI et Chromatic s’exécutent, puis les designers valident les modifications visuelles. Deux ingénieurs examinent ensuite l’API, l’accessibilité et l’architecture, avant que les designers ne fassent la fusion.
L’évaluation est répartie selon les compétences de chacun :
- Les designers sont responsables de la correction visuelle, des tokens, du mouvement et des états, tous validés lors de l’évaluation visuelle.
- Les deux ingénieurs s’occupent de l’API du composant, des aspects d’accessibilité, de l’architecture et du taux de couverture des tests.
L’évaluation visuelle est confiée aux designers et non aux ingénieurs pour des raisons pratiques. Ils valident une modification directement à l’endroit où elle apparaît, sans avoir à lire de différences ni attendre qu’un ingénieur examine une capture d’écran à leur place.
Auparavant et après
Le vieux processus permettait de créer un composant fonctionnel dans un Storybook interne, une demande de travail, puis un second composant dans la bibliothèque destinée à la mise en production. Les visuels étaient approuvés par mémoire ou par des ingénieurs qui examinaient une capture d’écran.
Dans le nouveau processus, les designers travaillent dans la même bibliothèque que celle utilisée pour construire le site en ligne, approuvent les pixels via Chromatic, et laissent deux ingénieurs examiner le résultat. Lorsqu’un composant convient déjà au système, il faut des heures pour passer d’un prototype fonctionnel à une modification intégrée, le tout étant soumis à des vérifications.
Les coûts acceptés par l’équipe
Le risque principal est le plus évident. Les concepteurs travaillant avec un agent peuvent créer quelque chose qui semble correct mais ne l’est pas : une API en conflit avec le reste de la bibliothèque, un contrôle sans nom accessible, ou une histoire qui ne suit que le chemin le plus simple. L’accès d’écriture permet à un tel composant d’être réellement fusionné. C’est pourquoi le contrat relève de deux ingénieurs et les aspects visuels du concepteur, afin que personne ne prétende examiner tout le travail.
La porte de fusion elle-même ne prévoit pas explicitement « deux ingénieurs ». GitHub compte deux approbations de n’importe qui disposant d’accès d’écriture ; donc cette association est une convention du modèle de revue. Si cette convention est négligée, le risque réapparaît.
Aujourd’hui, la revue est délibérément le goulot d’étranglement. Si ces deux reviewers sont lents, les gaspillages persistent sans disparaître.
Les concepteurs doivent également exécuter le répertoire localement. Les difficultés d’installation sont réelles, et la seule solution pour l’instant est un guide de contribution ainsi qu’une session d’accompagnement.
Finalement, cette approche est destinée aux composants qui s’intègrent au système. Un nouveau modèle véritable doit d’abord être ajouté à la bibliothèque par quelqu’un avant qu’un agent ne puisse l’imiter. Les composants présentant un état complexe, des mouvements interrompus ou une sémantique inhabituelle nécessitent encore que des ingénieurs les développent, et non simplement qu’ils les vérifient par la suite.
Ce qui s’applique aux autres équipes
- Développer chaque composant UI une seule fois. Lorsque les concepteurs peuvent générer du code fonctionnel adapté au système, ce qui suit doit être une revue.
- Conserver une seule bibliothèque de composants partagée. L’utilisation simultanée de Storybooks et le transfert de tickets entraînent des écarts, donc ce que les concepteurs développent doit être ce qui est finalement déployé.