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.
Semantic HTML has long been presented as a best practice. In the agentic era, it becomes something stronger again: trust infrastructure.
Why? Because an agent cannot rely only on appearance. It must understand intention. Native HTML helps declare that intention: heading, navigation, form, button, link, field, label, state.
The problem of opaque components
Part of the modern web has turned HTML into a neutral support for visual components. As long as the human understands and the crawler extracts the content, the site may appear acceptable.
But an agent must connect an action to a consequence. If that action is carried by a generic, poorly named, or late-rendered component, the agent must infer. That inference increases the risk of wrong target, wrong state, or wrong step.
The return of HTML does not mean abandoning frameworks. It means frameworks must respect the native grammar of the web.
Elements that carry action authority
A few simple elements become central:
- button to execute an action;
- link to navigate to a resource;
- label to name a field;
- heading to structure a section;
- form to declare a submission;
- navigation to expose main paths;
- disabled or selected state to qualify availability.
These elements are not decorative. They declare a function.
Minimal example
An explicit CTA should carry its intention in the text and in the element:
<button type="submit">Send the diagnostic request</button>This is not only cleaner. It is more reliable. The action, type, and label converge.
HTML, accessibility, and agenticity
Native HTML also feeds the Accessibility Tree. A correct structure reduces the number of compensatory attributes required. It makes roles more obvious and relationships easier to reconstruct.
The agentic web makes this coherence strategic. A system can combine visual rendering, DOM, Accessibility Tree, and structured data. The more these layers tell the same story, the less the agent must improvise.
What this means for front-end architectures
The question is not to choose between modernity and sobriety. The question is what must be server-rendered, what must be hydrated, and what must remain available even if JavaScript arrives late.
A sober architecture such as Astro can become relevant when it exposes content quickly and hydrates only what truly needs interaction. The principle is not anti-JavaScript. It is anti-opacity.
Conclusion
HTML becomes trust infrastructure again because it gives systems a stable base for understanding actions.
In a web that was only read, semantic approximations were sometimes tolerated. In a web that is manipulated, they become more costly. Code must carry intention again.