En qué destaca getdesign.md
Es la colección pública más grande de archivos DESIGN.md, se instala genuinamente con un solo comando y publica un informe State of DESIGN.md junto al catálogo. Si desea ver las diversas formas en que se escriben estos archivos, o si busca específicamente un brief derivado de un producto que admire, es el lugar indicado. Está mantenido por el equipo de VoltAgent, quienes también gestionan la lista awesome-design-md.
La diferencia estructural
Ambos productos instalan un DESIGN.md. La pregunta relevante es qué más llega al repositorio, ya que un brief de diseño es una mitad de un sistema de diseño y los tokens son la otra.
| getdesign.md | Identity Forge | |
|---|---|---|
| El brief escrito | Sí: un DESIGN.md | Sí: un DESIGN.md |
| Tokens de color semánticos | Sin archivo de tokens. Los valores aparecen en el brief como prosa | 28 roles, claro y oscuro, escritos en su tema |
| Ubicación de los valores | En el Markdown. Su hoja de estilos permanece intacta | En su hoja de estilos. El Markdown los referencia |
| Exportaciones de framework | Markdown | Variables CSS, @theme de Tailwind v3/v4, elemento de registro de shadcn, JSON DTCG/W3C |
| Origen del diseño | Análisis de los patrones observables de un producto existente | Un kit original, o generado a partir de su brief |
| Integración con el agente | Instale el archivo y el agente lo leerá | Herramientas MCP: buscar, emparejar una paleta, leer el brief, aplicar el kit |
La segunda y tercera fila son las que determinan qué ocurre realmente en su codebase. Si los valores de color existen solo dentro de un archivo Markdown, el agente los lee y luego los escribe en los componentes como valores literales, ya que no hay nada más a lo que hacer referencia. El resultado es un diseño documentado y una hoja de estilos no documentada, que es precisamente la situación que los semantic tokens existen para evitar.
Un brief con valores en prosa y sin un archivo de tokens no ofrece al agente ninguna referencia. Escribe literales y la hoja de estilos no aprende nada.
Esto no es una crítica al formato. Es una consecuencia de lo que puede ser la entrada de un catálogo. Un análisis del producto de un tercero no puede entregarle su archivo de tokens, porque no dispone de él.
Lo que un brief derivado de una marca puede y no puede incluir
Las entradas de getdesign.md son análisis de patrones observables públicamente, y sus páginas de marca lo indican directamente con avisos de no afiliación. Ese enfoque es correcto y debe tomarse literalmente. La pregunta interesante es qué sobrevive a dicha derivación.
| ¿Se transfiere? | Por qué | |
|---|---|---|
| Paleta y familia tipográfica | Sí | Directamente observable desde una página renderizada |
| Valores de espaciado y radio | En su mayoría | Observable, aunque determinar cuáles son sistemáticos y cuáles son casos aislados es una cuestión de criterio |
| Lo que el diseño evita hacer | Raramente | Las ausencias son invisibles a la observación. No se puede ver una sombra que nunca se utilizó |
| Por qué se tomó una decisión | No | Una densidad que sirve a un usuario avanzado durante todo el día es la respuesta incorrecta para una landing page, y el brief no puede saber cuál de los dos es usted |
La tercera fila es la importante y se aplica a cualquier brief derivado, independientemente de quién lo produzca. Analizamos 299 archivos DESIGN.md publicados y descubrimos que el 76% no contiene prohibiciones de ningún tipo: junto con un 86% que especifica los colores como hex puros sin rol semántico y un 57% que no nombra motivos distintivos. Las prohibiciones son donde realmente reside la identidad de un diseño, y son precisamente aquello a lo que un análisis externo tiene menos acceso.
Ese es el límite honesto al copiar la apariencia de cualquier producto admirado, y lo analizamos detalladamente en el análisis de Linear: la paleta es la parte menos distintiva del sistema, y las restricciones que hacen que funcione son la parte que no sobrevive a la extracción.
Un sistema generado, en vivo
Esto es lo que significa en la práctica "generar un sistema completo": el kit gratuito ambient-sage, renderizado a partir de sus tokens y fuentes reales, la misma carga útil que la CLI escribe en su repo:
Ambient Sage
Live renderRendered from the kit's actual tokens, fonts, and treatments
Typography
Plus Jakarta Sans
Color system
28 semantic roles, light + dark
Agent outputs
DESIGN.md, CSS, Tailwind, shadcn
npx shadcn add https://identityforge.io/r/ambient-sage.jsonDespués de ese comando, su globals.css contiene 28 roles nombrados en modo claro y oscuro, y el DESIGN.md se refiere a ellos por su nombre en lugar de repetir los valores hex. Ese es el acoplamiento que mantiene la veracidad del brief: cambie un token y el brief seguirá siendo preciso, porque nunca contuvo una copia.
¿Cuál debería utilizar?
- Elija getdesign.md si desea estudiar cómo se escriben los archivos DESIGN.md en diversos productos, o si busca específicamente un brief derivado de un diseño que admire y se siente cómodo proporcionando la capa de tokens usted mismo.
- Elija Identity Forge si desea un sistema original instalado como tokens funcionales más un brief correspondiente, con entrega vía MCP, CLI y shadcn, y exportaciones para cualquier stack que utilice.
- No son excluyentes. Leer las entradas del catálogo es una buena forma de calibrar qué tan específico debe ser un brief. Solo tenga en cuenta que un brief sin tokens deja la hoja de estilos sin cambios, por lo que, en cualquier caso, combínelo con una capa de tokens real.
Cualquiera que elija, realice la misma comprobación después: busque valores hex literales fuera de su archivo de tokens. Si el agente los está escribiendo en los componentes, el brief no está conectado a nada y tiene documentación en lugar de un sistema.
¿Es nuevo en este formato? Comience con qué es un DESIGN.md y cómo generar uno, y luego elija su herramienta en la guía fundamental.
Preguntas frecuentes
¿Cuál es la diferencia entre Identity Forge y getdesign.md?
getdesign.md publica análisis en formato DESIGN.md de productos conocidos, instalables mediante su CLI, además de un starter LaunchKit. Identity Forge genera un sistema de diseño original (28 roles de color semánticos en modo claro y oscuro, fuentes, reglas de layout y motivos) e instala el brief junto con los tokens a los que hace referencia, a través de MCP, una CLI o un registro de shadcn.
¿getdesign.md me proporciona design tokens?
Le proporciona un DESIGN.md que describe un diseño, con los valores indicados en el documento. No escribe un archivo de tokens semánticos en su hoja de estilos, lo cual es consecuencia de la naturaleza de una entrada de catálogo: un análisis de otro producto no puede entregarle el archivo de tokens de dicho producto.
¿Es Identity Forge una alternativa a getdesign.md?
Para obtener un sistema de diseño instalable, sí. Para explorar múltiples ejemplos prácticos del formato DESIGN.md, getdesign.md es la colección más amplia y ambos cumplen propósitos diferentes. Muchas personas consultan un catálogo para calibrar sus ideas e instalan un sistema generado para construir sobre él.
¿Puedo usar un DESIGN.md derivado de una marca que me guste?
Puede hacerlo, y es una forma razonable de ver el formato aplicado. Dos advertencias: un análisis externo rara vez captura lo que un diseño evita hacer, que es donde reside principalmente la identidad, y las decisiones de un diseño dependen de su audiencia: una densidad adecuada para una herramienta de uso intensivo es la respuesta incorrecta para una página que alguien escanea durante cuarenta segundos.
¿Es Identity Forge gratuito?
Los kits gratuitos y el registro de shadcn funcionan sin necesidad de cuenta. Solo se requiere una clave de API (desde /account/api-keys) para datos propios, una cuota de API superior y kits Pro.