AKRIBIS GroupBrand
Entrega
5.3

Datos para sitios y agentes

Propuesto

¿Qué hechos y reglas se publican como datos legibles por máquina?

Especificación

  1. 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).
  2. 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.
  3. 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.
  4. Todos se sirven con Access-Control-Allow-Origin: *, para que cualquier sitio o herramienta de AKRIBIS los lea desde otro origen.
  5. 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.
  6. 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ó.
  7. 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.

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.

Los datos (ADR-0022): lo que Brand decide también es un archivo, generado en cada build desde la misma fuente que esta página, en una dirección que no cambia. llms.txt son las reglas en texto plano para agentes: la especificación en inglés de cada tema propuesto o ratificado, el registro, los archivos y las decisiones.