Governance artifacts
Governance files brought into scope by this page
This page is anchored to published surfaces that declare identity, precedence, limits, and the corpus reading conditions. Their order below gives the recommended reading sequence.
Canonical AI entrypoint
/.well-known/ai-governance.json
Neutral entrypoint that declares the governance map, precedence chain, and the surfaces to read first.
- Governs
- Access order across surfaces and initial precedence.
- Bounds
- Free readings that bypass the canon or the published order.
Does not guarantee: This surface publishes a reading order; it does not force execution or obedience.
Public AI manifest
/ai-manifest.json
Structured inventory of the surfaces, registries, and modules that extend the canonical entrypoint.
- Governs
- Access order across surfaces and initial precedence.
- Bounds
- Free readings that bypass the canon or the published order.
Does not guarantee: This surface publishes a reading order; it does not force execution or obedience.
LLMs.txt
/llms.txt
Short discovery surface that points systems toward the useful machine-first entry surfaces.
- Governs
- Discoverability, crawl orientation, and the mapping of published surfaces.
- Bounds
- Incomplete readings that ignore structure, routes, or the preferred markdown surface.
Does not guarantee: A good discovery surface improves access; it is not sufficient on its own to govern reconstruction.
The important signal is not that llms.txt would suddenly become a ranking factor. That reading would be too fast, too sales-driven, and too fragile.
The important signal is deeper: the Google ecosystem is beginning to expose, through two different products, two different regimes of the contemporary web. On one side, Google Search continues to explain that llms.txt files or other special files are not required to appear in generative Search features. On the other side, Chrome Lighthouse introduces experimental Agentic Browsing audits that evaluate whether a site is built for machine interaction.
This is not a contradiction. It is a bifurcation.
The reading trap
The wrong conclusion would be: “Google validates llms.txt for AI SEO.”
The defensible conclusion is this: Google Search does not present llms.txt as a visibility condition for its generative features, while Chrome Lighthouse is beginning to treat llms.txt, the Accessibility Tree, visual stability, and some interaction signals as observable elements of agentic readiness.
The difference is decisive. Search seeks to find, rank, retrieve, display, and answer. An agent seeks to understand, traverse, manipulate, and act. These two regimes intersect, but they are not the same.
What Google Search actually says
Google Search Central’s documentation on optimization for generative Search features states that new machine-readable files, AI files, special markup, or Markdown files are not necessary in order to appear in Google Search generative experiences. It explicitly lists llms.txt among the things to ignore for Google Search.
That position is coherent with Search logic: Google does not want publishers to replace content quality, accessibility, structure, trust signals, indexability, or Search fundamentals with a decorative file aimed at AI systems.
It also protects against the market of false promises. As soon as a new file is named, some actors will try to sell it as a ranking shortcut. The Search position closes that door.
What Lighthouse signals in parallel
Chrome Lighthouse documentation for Agentic Browsing states that this experimental category does not work like classic categories with a weighted 0 to 100 score. Instead, it aims to collect data and provide actionable signals while agentic web standards emerge.
Within that frame, the llms.txt audit treats the file as an emerging convention for providing a machine-readable summary of a site’s content for LLMs and AI agents. The absence of the file should not be read as SEO failure. It indicates that a potential machine-orientation surface is not available.
The audits for accessibility for agents, visual stability, and WebMCP reveal the real shift: the interface is no longer only assessed as human experience or indexable document. It is progressively examined as a surface that an agent may read and manipulate.
Why this is not contradictory
The two positions answer two different questions.
Google Search answers: “What should be done for visibility in Google Search generative features?”
Lighthouse answers another question: “How can a site be built to better support agent interaction?”
The same file can therefore be unnecessary for Search and useful in an agentic audit. That is not incoherent. An XML sitemap can help discovery without guaranteeing ranking. Structured data can clarify an entity type without guaranteeing citation. An llms.txt file can orient machine reading without governing an answer. An Accessibility Tree can help an agent understand an interface without becoming a ranking factor.
What llms.txt can and cannot do
llms.txt can help expose important pages, hubs, policies, canonicals, context files, or machine-oriented surfaces. It can reduce discovery cost for a system trying to understand the general structure of a site.
But it cannot impose an interpretation. It cannot force an engine to cite a page. It cannot repair a contradictory corpus. It cannot make a form understandable. It cannot compensate for an unnamed button, ambiguous navigation, unstable layout, or poorly connected policy.
This is why llms.txt primarily belongs to machine discoverability, not to full agentic readiness. It is a documentary entry point. It is not proof of governance.
Agentic readiness is more demanding
Agentic readiness requires the interface itself to become interpretable. It asks whether an agent can understand available actions, their priority, their limits, their consequences, and the actual state of the path.
This requires coherence across several layers:
- visible text;
- initial HTML;
- DOM after hydration;
- Accessibility Tree;
- structured data;
- form labels;
- open, closed, selected, or disabled states;
- confirmations and errors;
- internal linking;
- machine files and policies.
A page that only succeeds at the documentary layer is not necessarily ready for agents. A page ready for agents must also support reliable action.
The real doctrinal opportunity
The market will try to turn this signal into a slogan: “Install llms.txt and become AI-ready.” That would be a reduction.
The more serious signal is this: machine readability and interface actionability are entering the perimeter of standard audits. What used to be discussed through architecture, accessibility, stability, and governance is gradually becoming verifiable through tools. Not completely. Not definitively. But enough to change the conversation.
This is exactly where the AI visibility, machine discoverability, and agentic readiness matrix becomes necessary. It avoids collapsing citation, discovery, reading, understanding, and action into one concept.
What should be done now
Stop selling isolated files. Audit reading and action conditions.
For a doctrinal site, this means explicit canonicals, definition pages, descriptive internal links, evidence, exclusions, machine surfaces, and a non-inference policy.
For a transactional site, it also means understandable forms, named buttons, associated errors, bounded sensitive actions, stable navigation, predictable paths, and a clear decision hierarchy.
For a WordPress site, it means not assuming that a plugin can make the whole site agent-ready. A plugin can help structure robots.txt, llms.txt, crawl rules, or some machine surfaces. It cannot, alone, fix confusing content architecture, an inaccessible theme, or an incoherent DOM.
Conclusion
The question is not: “Does llms.txt rank?”
The question is: “Does the site expose its content, intentions, actions, limits, and evidence clearly enough to be understood by systems that no longer only read, but may also act?”
Google Search closes the door to the SEO shortcut. Lighthouse opens the door to agentic auditing. Between the two, a more precise discipline is needed: agentic readiness.