ADR 0002: Exposición de Endpoints llms.txt y Markdown Crudo

Estado

Aceptado

Fecha

2026-09-27

Contexto

Los catálogos tradicionales de datos abiertos están diseñados exclusivamente para consumo humano visual a través de interfaces gráficas. Sin embargo, en el contexto actual, una gran parte de los investigadores y analistas emplean Agentes de IA (como Claude, GPT, Gemini o agentes locales) para descubrir fuentes de datos y redactar consultas analíticas.

Obligar a los agentes a parsear HTML complejo o interactuar con APIs propietarias genera alucinaciones sobre los nombres de columnas, esquemas incorrectos y alto consumo de tokens.

Decisión

1. Implementar la especificación canónica llmstxt.org en la ruta /llms.txt y /llm.txt.

2. Proveer una ruta consolidada /llms-full.txt que agrupa todos los esquemas, conceptos semánticos y descripciones en un único texto continuo para modelos con ventanas de contexto extendidas.

3. Exponer el endpoint /raw/[...slug] que entrega el archivo Markdown original exacto con cabecera Content-Type: text/markdown; charset=utf-8.

Consecuencias

• Agentes de IA pueden consultar y entender todo el ecosistema de datos de Bolivia en un solo llamado HTTP directo.
• Se eliminan las alucinaciones de esquemas al basarse en los contratos sintácticos originales de cada nodo.
• Compatibilidad directa con herramientas CLI como curl, jq y scripts de Python.