¿Qué es DESIGN.md?
DESIGN.md es un sistema escrito para máquinas: un markdown que explicita color, tipografía, espaciado y componentes para que una AI los aplique sin adivinar. Nació en Google Stitch y hoy, como especificación abierta, funciona en Claude Code, Cursor y cualquier agente que lea texto.
Qué es un DESIGN.md
DESIGN.md es un único Markdown que codifica un sistema completo de forma estructurada. Combina tokens legibles por máquina —normalmente YAML— con texto sobre color, tipografía, espaciado, formas, componentes y movimiento para que la AI aplique sin adivinar.
El nombre sigue README.md: texto plano, versionable y portátil. README explica un proyecto a una persona; DESIGN.md explica un diseño a la AI que vestirá tus diapositivas, sitio o producto.
En vez de pedir «moderno y limpio», colocas DESIGN.md en el proyecto y el agente aplica tus estilos exactos a todo lo que construye.
Origen del formato: Google Stitch
DESIGN.md llegó al público mediante Google Stitch, la herramienta de Google Labs. Stitch usa design.md como memoria persistente: guarda paleta, fuentes y reglas para que las pantallas no deriven con cada prompt.
En 2026 Google Labs publicó DESIGN.md como especificación abierta. Claude Code, Cursor y Codex lo leen desde la raíz, y aparecieron colecciones como awesome-design-md y catálogos curados como Curio.
Importa porque se vuelve lenguaje común entre sistemas y agentes: un archivo escrito una vez, entendido por la siguiente herramienta que uses.
Qué contiene un DESIGN.md
Primero van metadatos: nombre, esencia e indicadores como claro u oscuro. Es la orientación inicial.
Then the token sections, each stated as concrete values rather than adjectives: a color section (a named palette — background, ink, accents — as exact values like <hex>), a typography section (font families, weights, and a type scale in <px>/rem), a spacing section (a rhythm in <px>), and shape, shadow, and motion sections (radii, elevation, easing).
Por último, lógica de botones, tarjetas e inputs y notas sobre dónde encaja el estilo. Así la AI pasa de reglas a pantalla sin inventar valores.
Curio ships every style in its library as a complete file of this shape. The structure is open so anyone can see how a DESIGN.md is put together; the precise token values for each style are the paid product. The skeleton is public; the exact <hex> and <px> are what you unlock.
Por qué supera a una captura
Una captura o un ambiente pierde información y obliga a inferir: copia color pero no espaciado, tipografía pero no retícula. DESIGN.md elimina la adivinación al declarar valores que se aplican igual en cada pantalla.
Como archivo determinista, DESIGN.md es coherente y reutilizable. Gobierna la diapositiva uno y la cuarenta, la landing de hoy y el dashboard del mes próximo: un sistema fiable, no un aspecto accidental.
Al ser texto plano, vive en el repositorio, viaja por Git y convierte cambios de diseño en diffs revisables.
Cómo usa una AI un DESIGN.md
Entrégalo como convenga: en la raíz, pegado en chat, por enlace o mediante MCP. El modelo lee los tokens y genera componentes, diapositivas o páginas que ya coinciden con el estilo en vez de volver al promedio.
Como es Markdown normal, no queda ligado a un asistente. El mismo DESIGN.md funciona en chat, código o canalizaciones; la especificación viaja con el trabajo.
¿Debes escribir uno o elegirlo?
Escribe tu DESIGN.md cuando el sistema ya existe y te pertenece: tu marca o producto. Codificarlo una vez hace que todas tus herramientas lo apliquen fielmente.
Elige uno preparado si quieres Bauhaus, Swiss International o un estilo contemporáneo y no deseas reconstruirlo. Curio entrega cientos como DESIGN.md completos para aplicar en segundos por MCP, enlace o descarga.
FAQ
¿Quién creó DESIGN.md?
DESIGN.md lo introdujo Google Stitch para guardar el sistema. Google Labs lo publicó después como especificación abierta, por eso hoy lo entienden Claude Code, Cursor y bibliotecas como Curio.
¿Es DESIGN.md un estándar oficial?
Es una especificación abierta de Google Labs, no un estándar formal como W3C. En la práctica es Markdown con tokens, legible sin tipo propietario ni parser especial.
¿DESIGN.md solo funciona con Google Stitch?
No. Nació en Stitch, pero al ser Markdown abierto funciona con Claude Code, Cursor, Codex, chats o tu canalización. Colócalo en el proyecto o entrégalo por enlace.
¿Puedo ver gratis los valores reales?
La estructura de DESIGN.md es abierta. En Curio, los valores exactos son el producto de pago porque hacen utilizable el estilo; Free también incluye varios estilos gratuitos.
¿En qué se diferencia de tokens o Figma?
Los tokens y Figma sirven a herramientas y canalizaciones. DESIGN.md combina tokens y guía aplicada en un texto que la AI consume en una pasada, sin exportar desde un formato bloqueado.