La irrupción de los agentes para programar está obligando a replantear no solo cómo se escribe código, sino también cómo se transmite el criterio visual de un producto. En ese contexto aparece DESIGN.md, un proyecto abierto publicado en GitHub por google-labs-code que propone un formato específico para describir una identidad visual de forma comprensible tanto para humanos como para agentes de desarrollo. La idea es sencilla: dar a esos agentes una referencia persistente y estructurada de un sistema de diseño para que no improvisen cada interfaz desde cero.
El repositorio lo define como “una especificación de formato para describir una identidad visual a agentes de código” y plantea un enfoque híbrido: una capa de tokens legibles por máquina en formato YAML y otra de explicación en lenguaje natural en Markdown. Según la documentación, los tokens fijan valores exactos —colores, tipografías, espaciado, radios o componentes— mientras que la parte en prosa explica por qué existen esos valores y cómo deben aplicarse.
Eso convierte a DESIGN.md en algo más cercano a una ficha técnica viva del diseño que a una simple guía de estilo. En lugar de limitarse a decir “usa este azul” o “esta tipografía”, el formato intenta combinar la precisión de los design tokens con el contexto editorial que suele faltar en muchos sistemas automatizados. En la práctica, un agente podría leer el archivo y entender no solo qué color usar para un botón, sino también el tono general de la interfaz, la jerarquía visual y la intención de marca que hay detrás.
La especificación actual está todavía en versión alpha, algo que el propio proyecto subraya de forma explícita. No se presenta como un estándar cerrado ni como una norma de facto de la industria, sino como un formato en desarrollo. Aun así, ya incorpora una estructura bastante definida: front matter YAML al inicio del archivo, cuerpo en Markdown organizado en secciones con un orden canónico, reglas de validación y una pequeña herramienta de línea de comandos para comprobar errores, diferencias entre versiones y exportación de tokens.
Uno de los aspectos más interesantes es precisamente ese CLI. El proyecto incluye comandos como lint, diff, export y spec. Con ellos se pueden detectar referencias rotas entre tokens, avisar de problemas de contraste WCAG AA, encontrar tokens huérfanos, comparar dos versiones del sistema visual y exportar los valores a formatos como Tailwind theme config o DTCG tokens.json, este último inspirado en el trabajo del W3C Design Tokens Format. Es decir, DESIGN.md no quiere quedarse solo en una idea conceptual: intenta convertirse también en una pieza útil dentro del flujo real de diseño y desarrollo.
El repositorio también deja ver bien cuál es el problema que intenta resolver. Los agentes de código pueden generar componentes con notable soltura, pero muchas veces fallan en algo más básico: la coherencia visual entre pantallas, estados y decisiones de interfaz. DESIGN.md plantea una salida práctica a ese ruido. Si existe un archivo persistente en el repositorio con los colores, la tipografía, la lógica de espaciado y las reglas de uso, el agente deja de trabajar completamente “a ciegas” y pasa a tener una base de diseño mucho más estable.
Eso no significa que el formato vaya a resolver por sí solo el caos visual del software generado con IA. La propia propuesta tiene límites. Por un lado, depende de que alguien defina bien el sistema de diseño y mantenga ese archivo actualizado. Por otro, sigue siendo una convención nueva, todavía en fase temprana, sin garantía de adopción masiva ni de compatibilidad universal entre herramientas. Además, al aceptar contenido desconocido con advertencias en algunos casos y preservar secciones no reconocidas en otros, también deja claro que está priorizando flexibilidad sobre rigidez absoluta.
Aun con esas cautelas, el interés del proyecto es evidente. El repositorio ya supera las 4.100 estrellas y más de 300 forks en GitHub, una señal de que el tema toca una necesidad real en el ecosistema actual: cómo hacer que los agentes no solo programen, sino que respeten una identidad visual consistente. En una época en la que cada vez más interfaces se generan, adaptan o refactorizan con ayuda de IA, el diseño empieza a necesitar también su propio “README” para máquinas. Y eso es, en el fondo, lo que propone DESIGN.md.
Lo más probable es que el futuro no pase por un único formato universal, al menos a corto plazo. Pero sí parece claro que el desarrollo asistido por agentes necesita una capa más formal para el diseño, igual que ya existen convenciones para pruebas, documentación o configuración. Si DESIGN.md prospera, no será porque sustituya de golpe a Figma, Storybook o los sistemas de tokens ya implantados, sino porque puede actuar como un puente muy útil entre el criterio visual humano y la ejecución automatizada del código.
