Title: Can publisher-declared content routes improve agent web retrieval and citation fidelity?
I’m exploring an open proposal called index-ai and would value technical criticism from people building with web-enabled models and retrieval systems.
The problem I’m trying to isolate is simple: an agent can find the right website, but still has to infer the site’s structure, canonical content and relationships from a page built primarily for humans. That can mean processing a large rendered page, choosing among repeated or partial content, and relying on inference where the publisher could have declared intent.
index-ai proposes an optional publisher-side interface:
-
a discoverable manifest;
-
declared clean-content routes;
-
freshness and content-size signals;
-
optional typed relationships between content nodes.
It is not intended to replace crawling, browser use, Markdown conversion, llms.txt, sitemaps, Schema.org, or retrieval orchestration. The question is whether a small, declared interface could make publisher content more predictable for agents before they reconstruct it from HTML.
I’m specifically looking for objections:
-
Is this a real missing contract, or just unnecessary duplication?
-
Which failure modes would make publisher-declared routes unsafe or unreliable?
-
Which existing web primitives should be reused instead of introducing another format?
-
What is the minimum useful version an agent framework would realistically consume?
Specification: index-ai
Repository and discussions: GitHub - jordachmakaya/index-ai: An open specification for publishing structured, verifiable, retrieval-efficient content to AI agents. · GitHub
Concrete criticism is more useful than endorsement.