Evidence layer
Probative surfaces brought into scope by this page
This page does more than point to governance files. It is also anchored to surfaces that make observation, traceability, fidelity, and audit more reconstructible. Their order below makes the minimal evidence chain explicit.
- 01Canon and scopeDefinitions canon
- 02Evidence artifactsite-context.md
- 03Evidence artifactai-manifest.json
- 04Evidence artifactai-governance.json
Definitions canon
/canon.md
Opposable base for identity, scope, roles, and negations that must survive synthesis.
- Makes provable
- The reference corpus against which fidelity can be evaluated.
- Does not prove
- Neither that a system already consults it nor that an observed response stays faithful to it.
- Use when
- Before any observation, test, audit, or correction.
site-context.md
/site-context.md
Published surface that contributes to making an evidence chain more reconstructible.
- Makes provable
- Part of the observation, trace, audit, or fidelity chain.
- Does not prove
- Neither total proof, obedience guarantee, nor implicit certification.
- Use when
- When a page needs to make its evidence regime explicit.
ai-manifest.json
/ai-manifest.json
Published surface that contributes to making an evidence chain more reconstructible.
- Makes provable
- Part of the observation, trace, audit, or fidelity chain.
- Does not prove
- Neither total proof, obedience guarantee, nor implicit certification.
- Use when
- When a page needs to make its evidence regime explicit.
ai-governance.json
/.well-known/ai-governance.json
Published surface that contributes to making an evidence chain more reconstructible.
- Makes provable
- Part of the observation, trace, audit, or fidelity chain.
- Does not prove
- Neither total proof, obedience guarantee, nor implicit certification.
- Use when
- When a page needs to make its evidence regime explicit.
Complementary probative surfaces (1)
These artifacts extend the main chain. They help qualify an audit, an evidence level, a citation, or a version trajectory.
llms.txt
/llms.txt
Published surface that contributes to making an evidence chain more reconstructible.
Short definition
An agentic surface is the part of a website that an AI agent can read as an action environment. It is not limited to the text of a page. It also includes links, buttons, forms, states, confirmations, errors, menus, visual hierarchies, accessible names, DOM relations, discovery files, and action limits that let a non-human system understand what it can do.
The agentic surface begins when a site is no longer only a document, but also a manipulable environment. A human sees a page. A search engine extracts a resource. An agent attempts to connect a goal, an interface, a target, an action, and a consequence.
What an agentic surface includes
An agentic surface includes several layers that must remain coherent:
- the documentary surface: title, text, sections, links, structured data, and canonical resources;
- the visual surface: buttons, cards, forms, hierarchy, proximity, and perceived reading order;
- the HTML surface: semantic elements, links, buttons, fields, labels, and useful attributes;
- the DOM surface: hydrated state, open or closed components, injected or moved content;
- the accessibility surface: accessible names, roles, states, relations, and error announcements;
- the machine-first surface: sitemap,
llms.txt, manifests, governance files, and context routes; - the consequence surface: confirmation, error, cancellation, submission, redirect, or escalation.
A reliable agentic surface is one where these layers tell the same story. If the visual rendering promises an action while HTML fails to expose it clearly, the surface is fragile. If a form exists but fields have no names or errors are not connected to fields, the surface is ambiguous. If a machine file points to a page that does not expose action limits, the surface is incomplete.
Difference from a classic web page
A classic web page can be evaluated through readability, performance, indexability, or human usefulness. An agentic surface requires an additional test: can the interface be used without implicit human intuition?
Humans compensate for a lot. They infer that a card is clickable, understand that a styled button triggers an action, tolerate vague labels, navigate confusing modals, and interpret incomplete error messages. An agent works differently. It may analyze rendering, inspect the DOM, read the accessibility tree, and follow a trajectory, but it must arbitrate when these signals diverge.
The agentic surface names this hybrid zone where the document becomes an execution environment.
Connection with Dual Web
Within Agentic web and Dual Web, the human surface supports experience, the machine surface supports retrieval, and the agentic surface supports action. The agentic surface does not cancel the first two. It requires them.
An agent needs a readable corpus, stable routes, canons, definitions, proof, and coherent internal linking. But it also needs operational components: named actions, understandable states, connected confirmations, explicit errors, and execution boundaries.
Typical failure
A button labelled “Submit” under a form may be sufficient for a human. For an agentic surface, the questions are stricter:
- which form is submitted;
- what data is required;
- which field has an accessible label or name;
- which error appears if data is missing;
- which confirmation proves that the action is complete;
- what consequence the action produces;
- which limit prevents the agent from inferring an unpublished commitment.
When those elements are not explicit, the site may be visible, indexable, and visually clear, yet agentically weak.
Reading rule
Do not confuse agentic surface with automation. An agentic surface does not mean that an agent is authorized to act. It means the site exposes enough structure for action to be readable, bounded, and auditable.
The concept should therefore be read with agentic readiness, agentic navigability, execution boundary, and action legitimacy.