Inicio / Artículos

Permitiendo que los diseñadores envíen componentes directamente a producción con agentes de IA

Cómo un equipo web puso fin al ciclo de construir dos veces: los diseñadores escriben en la biblioteca de producción junto con agentes, los ingenieros revisan el contrato, y una semana de trabajo se reduce a una hora.

Editor: REACTAPP.TOP7 min de lectura1674 palabras

Fuentes: Design engineering at Bolt: shipping components with AI agents

La plataforma web pública de una empresa de transporte por aplicación llega a decenas de millones de personas al año en más de cincuenta mercados. Se basa en un sistema de diseño compartido que cuenta con más de ciento diez componentes de interfaz de usuario. El equipo de front-end cambió la forma en que se crean esos componentes: ahora los diseñadores entregan código funcional directamente a la biblioteca de producción con la ayuda de agentes de programación basados en IA, y el tiempo necesario para entregar los componentes pasó de aproximadamente una semana a unas horas. Lo interesante no es la velocidad, sino lo que el equipo eliminó para lograrlo y qué decidió conservar.

La brecha que un archivo de diseño no puede cerrar

El diseño automático, los estados de hover, el orden de enfoque y la dirección del texto caben todos en un archivo Figma. Pero no ocurre lo mismo con cada situación con la que debe lidiar un navegador. Tradicionalmente, los ingenieros se encargaban del resto: la API del componente, el modelo de teclado y lo que anuncia un lector de pantalla. Nadie registró qué decisiones pasaron silenciosamente de los diseñadores a los ingenieros a lo largo del proceso.

Los agentes de codificación reducen en gran medida ese trabajo de traducción. Un diseñador que trabaja junto a un agente ahora puede crear un componente que realmente funcione, lo cual deja otra tarea para todos los demás: revisar el componente en lugar de escribirlo nuevamente.

Cómo se construyó el mismo componente dos veces

Los diseñadores del equipo nunca se limitaron a Figma, aunque aún comienzan allí explorando los tokens y los estados que necesita un componente. El siguiente paso no fue una transferencia de responsabilidades; abrieron un agente de codificación y construyeron el componente dentro de un Storybook interno, donde cada estado se muestra de forma aislada. El agente generó una versión, los diseñadores la examinaron en diferentes temas, anchuras y direcciones de texto, describieron lo que no estaba bien y el agente lo modificó.

El resultado fue un componente real y no solo una imagen de él. Se compilaba, reaccionaba a un navegador real y sus estados podían ser seleccionados con clic.

Luego el trabajo se detuvo. El componente permaneció en ese Storybook interno con sus propias convenciones, mientras que el sitio de producción se montaba con una biblioteca completamente diferente. El resultado fue un par de Storybooks, cada uno una fuente de verdad, conectados únicamente por un ticket.

Dos fuentes de verdad se separan gradualmente. Un token de espaciado cambia en un lugar pero no en el otro. El modo oscuro o la orientación de derecha a izquierda solo existe en un lado. Los diseñadores ya han decidido cómo difiere el efecto al pasar el cursor del enfoque por teclado, o cómo debe ajustarse un largo texto en alemán, mientras que los ingenieros trabajan con una solicitud redactada antes de que se realizaran esas verificaciones. Dos copias exactas de un mismo componente se convierten poco a poco en dos cosas diferentes.

Por eso los ingenieros tomaron esa solicitud y volvieron a crear el componente dentro de la biblioteca de producción, basándose en una descripción escrita de algo que ya existía y funcionaba. En el tablero del proyecto, ambas versiones parecen tareas normales y no hay nada que parezca anormal.

Esa segunda versión parecía una medida de precaución, pero no lo era. Los diseñadores ya contaban con una versión en desarrollo, y los ingenieros la volvieron a escribir para que pudiera formar parte de la biblioteca que realmente utiliza el sitio de producción. La desviación era el resultado predecible de mantener dos Storybooks; se trataba de una característica estructural del sistema y no de una falta de disciplina.

Nunca fue el objetivo adoptar un nuevo título de puesto o una herramienta distinta. El flujo de trabajo seguía estando diseñado en torno a una imagen ya preparada, y los diseñadores hacía tiempo que habían dejado ese entorno. Volver a escribir todo era un desperdicio de esfuerzos, dos Storybooks garantizaban la desviación, y todo el ciclo de vida partía del supuesto de que la implementación era el paso lento. Con los agentes, escribir se volvió rápido, por lo que el retraso se trasladó a las etapas posteriores y a la reconstrucción intermedia.

En el nuevo flujo, las dos etapas de color ámbar del diagrama anterior, es decir, el mismo componente escrito dos veces, se fusionan en una sola. Los diseñadores lo escriben una vez, en la biblioteca de producción. La revisión se amplía, ya que ahora dos ingenieros además de los diseñadores aprueban las imágenes, mientras que antes un único ingeniero revisaba manualmente las diferencias. La expansión de la revisión es menor que la reducción en la implementación, y esa diferencia representa un ahorro. Para los componentes habituales que se ajustan al sistema de diseño, el proceso dura horas en lugar de un sprint completo.

De la reproducción a la evaluación

Una imagen entregada por los diseñadores deja a los ingenieros una sola tarea: reproducirla. El código funcional no deja nada que reproducir, por lo que la pregunta pendiente es si el componente es adecuado. ¿Su API se integra bien con el resto de la biblioteca? ¿Sus semánticas funcionan con lectores de pantalla? ¿Funciona correctamente en todos los puntos de interrupción y en ambas direcciones de texto? Esa siempre fue la pregunta importante, pero antes venía al final, después de haberse invertido en la escritura del código. Ahora es lo primero, y el mismo estándar de calidad cuesta menos porque la revisión abarca algo que ya existe.

Qué cambió realmente

La ingeniería de diseño aquí implica una propiedad compartida de un mismo artefacto. Los diseñadores pueden incluir componentes en el repositorio, mientras que los ingenieros se encargan de la API y la arquitectura. En lugar de pasar descripciones entre equipos, ambos grupos trabajan directamente en el componente en sí.

El cambio no requería herramientas ni títulos nuevos, solo acceso al código base correcto. Los diseñadores ahora trabajan directamente en la biblioteca de componentes que impulsa las páginas públicas, utilizando el ciclo de agent y Storybook que ya conocían. Lo que iteran es exactamente lo que se publica.

Eso solo funciona si el resultado del agente es seguro para revisar, por lo que el equipo plasmó sus expectativas en un archivo AGENTS.md. Las instrucciones allí establecen los estándares de calidad de la biblioteca:

  • Reutilizar los tokens existentes.
  • Desarrollar sobre primitivas accesibles.
  • Escribir historias para cada variante significativa.
  • No modificar código no relacionado.

El archivo también marca los límites, separando las partes públicas de las internas y de todo aquello que debería quedar fuera de la biblioteca de componentes.

Las reglas existen para proteger la biblioteca como producto. Las APIs públicas se mantienen tal como están, a menos que un cambio significativo sea intencional, las convenciones establecidas prevalezcan sobre patrones novedosos, y cada cambio sea lo suficientemente pequeño como para poder revisarlo con confianza. El objetivo no es simplemente tener código que funcione, sino código que siga siendo predecible para todos los equipos que dependen de él.

Una habilidad complementaria establece el orden de trabajo. Antes de comenzar a trabajar con un marco de Figma, un agente verifica si el componente o la interacción ya existe, decide si debe ser público o interno, luego elabora el plan de acción y verifica el resultado. El marco funciona como especificación visual; no es una fuente de valores de píxeles para copiar ni una excusa para inventar una API.

Con las instrucciones, las directrices y la secuencia definida, los agentes cuentan con el contexto y la estructura necesarios para crear componentes que encajen en la biblioteca.

El modelo de revisión

Los diseñadores abren una solicitud de integración. CI y Chromatic se ejecutan, y los diseñadores aceptan los cambios visuales. Luego, dos ingenieros revisan la API, la accesibilidad y la arquitectura, y los diseñadores realizan la fusión.

La revisión se divide según quién puede evaluar qué:

  • Los diseñadores son responsables de la corrección visual, los tokens, el movimiento y los estados, todo lo cual se aprueba en la revisión visual.
  • Los dos ingenieros se encargan de la API del componente, las semánticas de accesibilidad, la arquitectura y el alcance de las pruebas.

La revisión visual corre a cargo de los diseñadores y no de los ingenieros por una razón práctica: ellos aceptan un cambio en el mismo lugar donde aparece, sin necesidad de leer diferencias ni que un ingeniero mire atentamente una captura de pantalla en su nombre.

Antes y después

El antiguo proceso generaba un componente funcional en un Storybook interno, un ticket de trabajo, y luego un segundo componente en la biblioteca destinada al despliegue. Las imágenes se aprobaban por memoria o mediante la inspección de capturas de pantalla por parte de los ingenieros.

En el nuevo proceso, los diseñadores trabajan en la misma biblioteca a partir de la cual se construye el sitio en vivo, aprueban los detalles visuales en Chromatic y dejan a dos ingenieros para que revisen el resultado final. Cuando un componente ya se adapta al sistema, pasar de un prototipo funcional a una actualización integrada lleva horas, todo ello tiempo dedicado a revisiones.

Los costos que aceptó el equipo

El riesgo principal es el más obvio. Los diseñadores que trabajan junto con un agente pueden crear algo que parece correcto pero no lo es: una API que choca con el resto de la biblioteca, un control sin nombre accesible, o una historia que solo sigue el camino más fácil. Tener acceso de escritura significa que dicho componente puede integrarse realmente. Por esa razón, el contrato corresponde a dos ingenieros y los aspectos visuales al diseñador, para que nadie pretenda revisarlo todo.

La propia puerta de integración no especifica “dos ingenieros”. GitHub cuenta con dos aprobaciones de cualquier persona que tenga acceso de escritura, por lo que la asociación entre ingenieros y diseñadores es una convención del modelo de revisión. Si esta convención se incumple, el riesgo vuelve a aparecer.

La revisión se ha convertido intencionadamente en el cuello de botella. Si esos dos revisores son lentos, el desperdicio persiste y no desaparece.

Los diseñadores también deben ejecutar el repositorio localmente. La dificultad para configurarlo es real, y hasta ahora la única solución ha sido una guía de contribuciones y una sesión de trabajo en pareja.

Finalmente, este enfoque está destinado a componentes que se adaptan al sistema. Antes de que un agente pueda imitarlos, alguien debe agregar un patrón verdaderamente nuevo a la biblioteca. Los componentes con estado denso, movimiento interrumpible o semántica inusual siguen necesitando que ingenieros los escriban, y no solo que los revisen posteriormente.

Qué se aplica a otros equipos

  • Construir cada componente de interfaz de usuario una sola vez. Cuando los diseñadores pueden generar código funcional que se adapte al sistema, lo siguiente debería ser una revisión.
  • Mantener una única biblioteca de componentes compartida. El uso simultáneo de Storybooks y la transferencia de tareas generan desviaciones, por lo que lo que construyan los diseñadores debe ser lo que se envíe finalmente.
  • Coloque barreras de protección en los lugares donde los agentes puedan seguirlas. Las instrucciones escritas y las convenciones guían a los agentes hacia los componentes adecuados y les impiden introducir cambios accidentales o seguir patrones erróneos.
  • Reserve el juicio técnico para los casos en que sea realmente necesario. Los nuevos patrones, los estados complejos y la accesibilidad personalizada siguen requiriendo habilidades técnicas, mientras que el trabajo rutinario se beneficia más al verificar los acuerdos de un componente que al volver a escribir el diseño.