guía
¿Qué es DESIGN.md? (y AGENTS.md, CLAUDE.md y llms.txt)
DESIGN.md es un archivo de texto que describe el sistema visual de una marca (colores, tipografía, espaciado, componentes y reglas) para que personas y herramientas de IA trabajen sobre las mismas decisiones. Vive en un proyecto o va adjunto a un chat, y las herramientas de IA lo leen como contexto antes de escribir o diseñar.
Los archivos que vas a encontrar
| Archivo | Qué es | Quién lo lee |
|---|---|---|
DESIGN.md | El sistema visual completo de la marca en markdown. brandmarkdown sigue el formato publicado por Google Labs (github.com/google-labs-code/design.md): tokens en un bloque de cabecera, reglas en el cuerpo. | Personas, Claude, ChatGPT, Cursor, v0, Lovable |
AGENTS.md | Instrucciones para agentes de IA que programan en un repositorio. | Codex, Jules, Aider y otros agentes que leen AGENTS.md |
CLAUDE.md | Memoria del proyecto que Claude Code carga en cada sesión dentro de esa carpeta. | Claude Code |
.cursor/rules/*.mdc | Reglas que Cursor aplica a los archivos que coinciden. | Cursor |
llms.txt | Un índice corto en la raíz de tu sitio web que indica a los buscadores con IA y a los agentes tus páginas clave. | Buscadores con IA, agentes |
Por qué markdown
Un manual de marca en PDF está escrito para personas y a un modelo le cuesta usarlo. Markdown es texto plano con títulos y tablas: el modelo lo lee con exactitud, y tú puedes guardarlo en el mismo lugar que tu sitio web o tus prompts.
Mira un ejemplo completo: el DESIGN.md de una marca de ejemplo (en inglés).