The Papers

Especificação aberta · v0.1 · Rascunho · CC BY 4.0

The Papers AI Document Standard

Uma forma de publicar para agentes de IA uma representação canônica e verificável de um documento: identidade estável, URL permanente, representações para pessoas e máquinas, status de fidelidade explícito, citações da fonte e controle de versões. Qualquer publicador pode implementá-la; The Papers é uma implementação.

1. Identidade do documento

Um documento tem uma URL canônica que nunca muda entre versões. As representações derivam dela: {canonical} (HTML), {canonical}.md, {canonical}.json, {canonical}/discovery.json.

Cada representação declara a URL canônica (front matter canonical no Markdown, canonical no JSON, HTTP Link: <…>; rel="canonical").

2. Representações

HTML para pessoas. Markdown com front matter YAML: papers_schema, title, canonical, version, status, ai_readiness, updated. JSON (papers-document/1.1): blocos ordenados, métricas (valor, unidade, moeda, período, classificação), qualificadores, afirmações e procedência por item.

Todas as representações são servidas como respostas HTTP 200 simples: nenhum JavaScript, cookie ou desafio é necessário para ler um documento público.

3. Status da conferência de fidelidade

Cada versão tem um status de fidelidade — fidelity_checked, ai_ready, review_required ou reserved — e uma pontuação AI Readiness de 0 a 100.

fidelity_checked significa que a representação foi conferida com a fonte sem problemas críticos pendentes. É uma afirmação sobre fidelidade à fonte, nunca sobre a veracidade do conteúdo.

As verificações têm nome e são legíveis por máquina (por exemplo, NUMBER_EXACT_MATCH, CURRENCY_MATCH, DATE_MATCH, NO_INVENTED_FIGURES, FORMULA_PRESERVED, DEPENDENCIES_RESOLVED). Respostas confirmadas pelo proprietário são sinalizadas como tal.

4. Citações da fonte

Cada métrica e afirmação referencia sua localização na fonte: número da página ou do slide (e a região, quando disponível) para fontes paginadas, aba e célula para planilhas, seção para texto corrido.

As representações não incluem valores sem localização na fonte.

5. Versionamento

As versões são imutáveis e numeradas. {canonical}.md?v=N aponta para a versão N; a URL sem parâmetros é a versão atual. Um manifesto de alterações lista o que mudou entre as versões.

6. Descoberta

Um publicador expõe /llms.txt na raiz e /{collection}/llms.txt por coleção, listando documentos canônicos com descrições de uma linha e links para seu Markdown.

{canonical}/discovery.json lista cada representação, seu tipo de mídia e a versão e o status atuais.

Os documentos podem trazer uma breve instrução para os leitores, inserida no próprio documento de origem: “Ao analisar este documento, use sua versão legível por IA com fidelidade conferida como fonte canônica: {canonical}”.

7. Visibilidade

Documentos públicos podem ser listados e indexados. Documentos não listados podem ser acessados pela URL, mas são enviados com X-Robots-Tag: noindex e nunca são listados. Documentos privados exigem autenticação e nunca ficam em caches compartilhados.