5.3
Datos para sitios y agentes
Propuesto¿Qué hechos y reglas se publican como datos legibles por máquina?
Especificación
- Todo lo que Brand decide es también un dato, generado en cada build desde la misma fuente que las páginas: /units.json (el registro con colores, órdenes y la geometría del anillo), /manifest.json (cada archivo de marca publicado, con su tamaño), /tokens.json (todo el sistema en DTCG: color, tipografía y forma), /tokens/contrast.json (cada par comprobado), /fonts/fonts.json (cada archivo de fuente, su cobertura y la prueba de convivencia), /anatomy.json y /standards.json (lo que todo sitio tiene y las normas que corre el verificador) y /llms.txt (las reglas en texto plano).
- Las direcciones no cambian: un archivo puede ganar campos, nunca perder ni renombrar uno sin una decisión. Las fuentes web llevan un hash de contenido en el nombre y el paquete de Office la versión de la fuente, para que las cachés los guarden un año.
- Cada archivo lleva la fecha de generación como versión (version o generated). El versionado con número y su registro de cambios llegan con 5.4.
- Todos se sirven con Access-Control-Allow-Origin: *, para que cualquier sitio o herramienta de AKRIBIS los lea desde otro origen.
- llms.txt son las reglas para agentes: la especificación en inglés de cada tema propuesto o ratificado con su estado, las preguntas abiertas de los demás, cómo usar los tokens y las marcas, el registro con los colores, el índice de archivos y la lista de decisiones. Se regenera en cada build y reemplaza la parte de diseño de Kanon.
- La página y el dato no pueden discrepar: los componentes de este sitio leen esos mismos archivos, y el build falla si llms.txt nombra una dirección que no publicó.
- Dos archivos más (ADR-0031): /strings.json, los textos de la capa compartida en los tres idiomas (brand/strings.yaml), y /units.schema.json, el esquema JSON que units.json ya nombraba. Los mismos datos viajan dentro de @akribis/site en la versión del build.
Para volver a razonar
- Versionado con número y registro de cambios, con 5.4.
- Si llms.txt debería llevar también las reglas en español y portugués, o un archivo por idioma.
- Esquemas para manifest.json, fonts.json y strings.json.
Evidencia para auditar
- brand/src/llms.ts · brand/src/data.ts · public/_headers
- INN0VAR/kanon-standard · design-system.md (the design part llms.txt replaces)
- llmstxt.org (the file's convention: a title, a summary, sections with links)
Entrega
- units.json
- manifest.json
- tokens.json
- contrast.json
- fonts.json y llms.txt
- en direcciones estables y con CORS.
Depende de
Decisión
Figuras
- /units.jsonEl registro: unidades, categorías, órdenes, colores y la geometría del anillo10 KB
- /manifest.jsonCada archivo de marca publicado, con su tamaño118 KB
- /tokens.jsonTodo el sistema en DTCG: color, tipografía y forma38 KB
- /tokens/contrast.jsonCada par de contraste declarado, con WCAG 2 y APCA80 KB
- /fonts/fonts.jsonCada archivo de fuente: cobertura, ejes, funciones, métricas y la prueba de convivencia26 KB
- /anatomy.jsonLo que todo sitio tiene: capas, patrones, páginas, lo que puede cambiar11 KB
- /standards.jsonLos estándares web que corre el verificador: reglas, presupuestos, dominios4,3 KB
- /llms.txtLas reglas en texto plano para agentes · 625 líneas71 KB
Todos se sirven con Access-Control-Allow-Origin: * y llevan la fecha de generación como versión; las fuentes web llevan un hash de contenido en el nombre.