Dados para sites e agentes

Especificação

1. Tudo o que a Brand decide é também um dado, gerado em cada build a partir da mesma fonte que as páginas: /units.json (o registro com cores, ordens e a geometria do anel), /manifest.json (cada arquivo de marca publicado, com seu tamanho), /tokens.json (todo o sistema em DTCG: cor, tipografia e forma), /tokens/contrast.json (cada par verificado), /fonts/fonts.json (cada arquivo de fonte, sua cobertura e o teste de convivência), /anatomy.json e /standards.json (o que todo site tem e as normas que o verificador roda) e /llms.txt (as regras em texto simples).
2. Os endereços não mudam: um arquivo pode ganhar campos, nunca perder nem renomear um sem uma decisão. As fontes web levam um hash de conteúdo no nome e o pacote do Office a versão da fonte, para que os caches os guardem por um ano.
3. Cada arquivo leva a data de geração como versão (version ou generated). O versionamento numerado e seu registro de mudanças chegam com 5.4.
4. Todos são servidos com Access-Control-Allow-Origin: *, para que qualquer site ou ferramenta da AKRIBIS os leia de outra origem.
5. llms.txt são as regras para agentes: a especificação em inglês de cada tema proposto ou ratificado com seu estado, as perguntas abertas dos demais, como usar os tokens e as marcas, o registro com as cores, o índice de arquivos e a lista de decisões. É regenerado em cada build e substitui a parte de design do Kanon.
6. A página e o dado não podem discordar: os componentes deste site leem esses mesmos arquivos, e o build falha se llms.txt nomear um endereço que não publicou.
7. Dois arquivos a mais (ADR-0031): /strings.json, os textos da camada compartilhada nos três idiomas (brand/strings.yaml), e /units.schema.json, o esquema JSON que units.json já nomeava. Os mesmos dados viajam dentro de @akribis/site na versão do build.

Para repensar

• Versionamento numerado e registro de mudanças, com 5.4.
• Se llms.txt deveria levar também as regras em espanhol e português, ou um arquivo por idioma.
• Esquemas para manifest.json, fonts.json e strings.json.

Evidência 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 e llms.txt
• em endereços estáveis e com CORS.

Decisão

• ADR-0022 Publish the brand as data at stable addresses, with llms.txt as the rules for agents Proposta
• ADR-0031 Deliver the shared layer of every site as one Astro package with a starter, and check each build inside it Proposta