
DESIGN.md: el archivo que le enseña a la IA a diseñar como un profesional
11 min readHace unos días encontré styles.refero.design y tardé exactamente diez minutos en entender que cambia la forma en que trabajo con herramientas de IA. No es una librería de componentes, no es un generador de UI, no es otro Figma. Es algo más simple y más poderoso: una colección de archivos DESIGN.md con los tokens de diseño reales de más de dos mil productos y empresas, listos para que tu agente de IA los lea y los aplique desde el primer prompt.
La diferencia clave entre un archivo de tokens JSON y un DESIGN.md: el JSON define valores, el DESIGN.md define valores más el contexto semántico de cuándo y cómo usarlos. La IA necesita los dos.
Tip de flujo de trabajo: si tu cliente ya usa un producto cuyo sistema de diseño está en Refero, muéstrale el DESIGN.md en la primera reunión. Es la forma más rápida de alinear expectativas visuales antes de escribir una sola línea de código.
Para proyectos propios donde no quieres copiar el sistema de otro, el formato DESIGN.md también sirve como documentación viva de tu propio sistema de diseño. Documenta tus tokens una vez, y todos los agentes que participen en el proyecto los respetan automáticamente.



