# DESIGN.md: conserva tokens y criterios de tu sistema visual

> Comparte con los agentes los valores y las razones de tu diseño en un archivo que puedes validar y comparar entre versiones.

Verificado el 27 oct 2026.

## Qué es

DESIGN.md es una especificación de Google Labs Code para describir una identidad visual a agentes. Une tokens legibles por máquinas con explicaciones en Markdown.

## Para qué te sirve

- Cuando una nueva sesión vuelve a elegir colores y tipografías distintos.
- Cuando necesitas revisar cambios del sistema visual por separado del código.
- Cuando quieres exportar tokens a CSS u otras herramientas.

## Cómo funciona

Los valores normativos se escriben en YAML, al inicio o dentro de secciones. La prosa explica cómo aplicarlos. La CLI comprueba estructura y referencias, revisa ciertos pares de contraste y compara dos versiones para señalar cambios y regresiones.

## Antes de empezar

Necesitas un archivo DESIGN.md con los valores reales de tu producto y Node.js y npm/npx disponibles. La especificación documenta colores, tipografía, espaciado, formas y componentes. Empieza por una muestra pequeña de tu sistema existente.

## Límites y alternativas

El formato sigue en fase alfa según la especificación consultada. Un archivo válido no garantiza que la aplicación respete los tokens ni que toda la interfaz sea accesible. Awesome-design-md aporta ejemplos de sistemas; este proyecto define el formato y sus herramientas.

## Recursos

- [Repositorio original](https://github.com/google-labs-code/design.md) - 28551 estrellas; licencia Apache-2.0 por GitHub.
- [Fuentes y documentación consultadas](https://github.com/google-labs-code/design.md/tree/6e5da5382f41edbba9d73b2c62f33f32e9971f15) - ejemplos y configuración.
- [Último commit comprobado](https://github.com/google-labs-code/design.md/commit/6e5da5382f41edbba9d73b2c62f33f32e9971f15) - 2026-10-16.
- [Condiciones de licencia](https://github.com/google-labs-code/design.md/blob/main/LICENSE) - archivo publicado por el proyecto.