The Papers

Abrir especificación · v0.1 · Borrador · CC BY 4.0

The Papers AI Document Standard

Una forma de publicar para agentes de IA una representación canónica y verificable de un documento: una identidad estable, una URL permanente, representaciones para personas y máquinas, un estado de fidelidad explícito, citas de la fuente y control de versiones. Cualquier editor puede implementarlo; The Papers es una implementación.

1. Identidad del documento

Un documento tiene una URL canónica que nunca cambia entre versiones. Las representaciones derivan de ella: {canonical} (HTML), {canonical}.md, {canonical}.json, {canonical}/discovery.json.

Cada representación declara la URL canónica (front matter de Markdown canonical, JSON canonical, HTTP Link: <…>; rel="canonical").

2. Representaciones

HTML para personas. Markdown con front matter YAML: papers_schema, title, canonical, version, status, ai_readiness, updated. JSON (papers-document/1.1): bloques ordenados, métricas (valor, unidad, moneda, periodo, clasificación), matizaciones, afirmaciones y procedencia por elemento.

Todas las representaciones se sirven como respuestas HTTP 200 simples: no se requiere JavaScript, cookies ni desafíos para leer un documento público.

3. Estado de la comprobación de fidelidad

Cada versión tiene un estado de fidelidad — fidelity_checked, ai_ready, review_required o reserved — y una puntuación AI Readiness de 0 a 100.

fidelity_checked significa que la representación se comprobó con la fuente sin problemas críticos sin resolver. Es una afirmación sobre la fidelidad a la fuente, nunca sobre la veracidad del contenido.

Las comprobaciones tienen nombre y son legibles por máquina (p. ej., NUMBER_EXACT_MATCH, CURRENCY_MATCH, DATE_MATCH, NO_INVENTED_FIGURES, FORMULA_PRESERVED, DEPENDENCIES_RESOLVED). Las respuestas confirmadas por el propietario se marcan como tales.

4. Citas de la fuente

Cada métrica y afirmación referencia su ubicación en la fuente: número de página o diapositiva (y región, si está disponible) en fuentes paginadas, hoja y celda en hojas de cálculo, sección en texto continuo.

Las representaciones no incluyen valores sin ubicación en la fuente.

5. Versionado

Las versiones son inmutables y numeradas. {canonical}.md?v=N apunta a la versión N; la URL sin parámetros es la versión vigente. Un manifiesto de cambios indica qué cambió entre versiones.

6. Descubrimiento

Un publicador expone /llms.txt en su raíz y /{collection}/llms.txt por colección, con la lista de documentos canónicos, una descripción de una línea y enlaces a su Markdown.

{canonical}/discovery.json lista cada representación, su tipo de medio y la versión y estado vigentes.

Los documentos pueden incluir una breve instrucción para los lectores, colocada en el propio documento fuente: «Al analizar este documento, usa su versión legible por IA con fidelidad comprobada como fuente canónica: {canonical}».

7. Visibilidad

Los documentos públicos pueden listarse e indexarse. Los documentos no listados son accesibles por URL, pero se envían con X-Robots-Tag: noindex y nunca se listan. Los documentos privados requieren autenticación y nunca se guardan en cachés compartidas.