Guía para LLMs y agentes
Cómo esta guía se vuelve fuente de verdad no solo para humanos, sino para modelos y agentes.
Este design system está pensado para que un LLM lo entienda con solo recibir la URL, igual de bien que un humano leyendo esta página. Ese es un requisito de primera clase, no un extra.
El patrón llms.txt
Al construir el sitio, un script recorre el contenido de los capítulos y genera dos archivos en la raíz:
/llms.txt— índice conciso: qué es el sistema, sus fundamentos y enlaces a cada capítulo. Es lo primero que se le pasa a un modelo./llms-full.txt— todo el contenido editorial en texto plano, listo para pegar en el contexto de un LLM.
Como se generan desde los mismos .mdx que lees aquí, humano y máquina nunca divergen.
AGENTS.md
En la raíz del repositorio, AGENTS.md da instrucciones directas a agentes de código (Claude
Code, Cursor, Windsurf): qué fuente usar, cómo elegir un componente, qué tokens aplicar y qué
evitar. Cualquier proyecto de Legalty puede copiarlo para alinear a sus asistentes.
Cómo pedirle a un LLM que use el sistema
"Usa el design system de Legalty descrito en
https://<host>/llms-full.txt. Respeta los tokens--lg-*, los radios rounded y la partición tipográfica Poppins/Inter/Spline Sans Mono. Construye los componentes con HeroUI."
Estructura recomendada de un DESIGN.md por proyecto
Cada app puede tener un DESIGN.md breve que enlace a esta guía y documente solo sus
particularidades:
- Fuente de verdad — enlace a esta guía y a
/tokens.json. - Decisiones locales — lo que difiere o extiende, con su porqué.
- Componentes propios — los que no están en HeroUI y son específicos del producto.
Regla de oro: una sola fuente (theme/tokens.ts + los
.mdx) y todo lo demás —CSS, JSON, llms.txt— se genera. Editar el
origen, nunca el derivado.