Skip to content

Framework

Agentic discoverability framework

Proposed framework for decomposing and evaluating the passage from digital presence to consideration, selection and faithful restitution by agents.

CollectionFramework
TypeFramework
Layertransversal
Version0.1-proposed
Published2026-08-27
Updated2026-08-27

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.

  1. 01Canonical AI entrypoint
  2. 02Public AI manifest
  3. 03LLMs.txt
Entrypoint#01

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.

Entrypoint#02

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.

Discovery and routing#03

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.

Framework status

The Agentic discoverability framework is a versioned proposal. Version 0.1 formalizes a vocabulary, a transition chain, axioms and an evidence regime.

It is not a standard, certification or adopted industry protocol. It does not promise that an object will be cited, recommended or selected by a third-party system.

The proposed canonical definition owns the term. This framework organizes its application and observation.

Problem addressed

Visibility measurements often compress several states: a resource exists, it can be retrieved, it appears in an answer, it is cited, compared, recommended or used.

These states are not equivalent.

A system may:

  • find a resource without resolving the entity correctly;
  • resolve the entity without understanding its offer;
  • understand the offer without considering it for the current intent;
  • consider it without selecting it;
  • select it while representing it incorrectly;
  • recommend it without being able to invoke it or act with it.

The framework prevents these states from being silently merged.

Unit of analysis

Every observation must declare at least:

D = object × intent × agent × context × time

Where:

  • object means an entity, content item, service, offer, resource or digital capability;
  • intent means the problem, need, comparison, search, decision or action;
  • agent means the system, model, version, configuration and available tools;
  • context means language, region, constraints, available data, user profile and session state;
  • time means an observation instant or window.

A conclusion that omits one of these dimensions must be qualified as partial.

Transition chain

The public model can be summarized as:

Presence → Exposure → Access → Resolution → Interpretation → Admissibility → Consideration → Selection → Restitution

These nine gates do not claim to reproduce the internal architecture of every system. They are a verification grid for transitions an observer may attempt to establish.

1. Presence

Question: does the object exist in an addressable and sufficiently stable environment?

Possible evidence: route, identifier, page, catalogue entry, resource, version and publication date.

Typical failures: absent object, unpublished surface, missing version or unrepresented entity.

2. Exposure

Question: can a system learn that the object exists?

Possible evidence: internal links, sitemap, catalogue, index, structured data, discovery surface or qualified external relation.

Typical failures: orphan surface, poor routing, incomplete catalogue or contradictory signal.

3. Accessibility

Question: can the system reach and read the resource under applicable conditions?

Possible evidence: HTTP response, usable rendering, access policy, authentication, format negotiation and route stability.

Typical failures: blocking, empty rendering, critical dependency on a late state, ambiguous permission or inaccessible resource.

4. Resolution

Question: is the object correctly identified and distinguished from adjacent objects?

Possible evidence: identifiers, canonical name, relations, version, owning organization and declared scope.

Typical failures: homonymy, brand merge, wrong version or attribution to the wrong entity.

5. Interpretation

Question: are role, meaning, conditions and boundaries reconstructed faithfully?

Possible evidence: canon-output comparison, claim matrix, scope tests and omission detection.

Typical failures: expanded role, omitted condition, invented capability or erased conceptual distinction.

6. Admissibility

Question: can the information or capability legitimately support the current intent given its authority, provenance, state and limits?

Possible evidence: canonical source, source hierarchy, dated proof, applicability condition and declared authority.

Typical failures: weak source, stale state, insufficient evidence, inapplicable scope or missing permission.

7. Consideration

Question: does the object enter the field of relevant options for the declared intent?

Possible evidence: instrumented-agent trace, explicit candidate list, visible comparison or routing explanation.

Typical failures: accessible object never considered, implicit filter, incompatible context or ignored candidate.

In a black-box system, this gate is often NOT_EVALUATED.

8. Selection

Question: is the object chosen, recommended, cited as a primary source or retained for an action?

Possible evidence: final output, explicit recommendation, source choice, invocation or traced decision.

Typical failures: competitor selected, object demoted, unsupported choice or out-of-context recommendation.

9. Restitution

Question: is the selected object represented faithfully with the required limits, attribution and conditions?

Possible evidence: canon-output comparison, attribution, claim accuracy and preservation of exclusions.

Typical failures: incorrect description, misleading citation, removed conditions or expanded scope.

Axioms

1. Relationality axiom

Discoverability is never absolute. It depends on the object, intent, agent, context and time.

2. Non-equivalence axiom

Presence, retrieval, understanding, citation, consideration, recommendation, selection and action are not interchangeable.

3. Eligibility axiom

A missing recommendation is not a failure when the object was not appropriate for the intent. Recommendation and selection rates must use scenarios in which the object was genuinely eligible.

4. Fidelity axiom

An appearance or selection based on an incorrect representation is not a complete success.

5. Observability axiom

An unobservable internal step must not be asserted. The correct status is NOT_EVALUATED, not an invented explanation.

6. Temporality axiom

Every observation is tied to a system version, region, language, configuration and time.

7. Permission separation axiom

Discovery does not grant permission to train, extract, invoke, transact or act.

Evidence statuses

Each gate receives an explicit status:

Status Meaning
OBSERVED The transition is directly supported by an inspectable trace or output.
SUPPORTED_INFERENCE The conclusion is inferred from declared evidence but not directly observed.
NOT_EVALUATED Available evidence does not support evaluation of the transition.
NOT_APPLICABLE The transition does not apply to the scenario or object type.
FAILED Observable evidence establishes that the expected transition failed.

SUPPORTED_INFERENCE must never be presented as OBSERVED.

Three observation modes

Mode 1: surface audit

This mode verifies what the publisher controls directly:

  • routes and canonicals;
  • HTML and structured data;
  • discovery surfaces;
  • entity graphs;
  • access policies and conditions;
  • service or capability catalogues;
  • provenance, versions and source hierarchy.

It measures controllable preparation. It does not prove consideration or selection by a third party.

Mode 2: instrumented agent

A controlled agent runs with traces that expose:

  • consulted resources;
  • identified candidates;
  • criteria;
  • rejections;
  • selected source or capability;
  • possible invocation;
  • produced restitution.

This is the preferred mode for directly evaluating consideration and selection.

Mode 3: external black-box panel

Versioned scenarios are submitted to several external systems. Controlled variation may include language, region, intent, constraints, wording and time.

Only visible outputs are declared observed. Internal mechanisms remain NOT_EVALUATED.

Three output profiles

Controllable readiness profile

This profile describes what the publisher can correct:

  • resource exposure;
  • entity resolution;
  • clarity of offers and capabilities;
  • provenance and authority;
  • boundaries, permissions and conditions;
  • route and interface stability.

Observed discoverability profile

This profile describes what systems actually do in tested scenarios:

  • appearance;
  • citation;
  • inclusion in comparison;
  • recommendation;
  • selection;
  • variation across agents, languages, regions and time.

Interpretive integrity profile

This profile describes restitution quality:

  • claim fidelity;
  • attribution;
  • scope compliance;
  • preservation of limits;
  • conformity with the canonical source;
  • absence of unjustified expansion.

These profiles must not be silently merged.

Initial metrics

Version 0.1 forbids a universal score out of 100. It allows separate metrics with declared denominators and limits.

Metric Object
surface_exposure_coverage Coverage of expected surfaces that are actually exposed.
entity_resolution_fidelity Accuracy of reconstructed identity.
claim_fidelity Conformity of claims with canonical sources.
source_precedence_compliance Compliance with the declared authority order.
observed_appearance_rate Share of observed scenarios in which the object appears.
eligible_recommendation_rate Recommendations among scenarios where the object was genuinely eligible.
selection_rate_given_inclusion Selections among scenarios where inclusion was itself observable.
attribution_fidelity Accuracy of the association between claim and source.
cross_agent_variance Result variation across comparable agents or environments.
language_parity_gap Difference between languages for equivalent scenarios.
temporal_stability Variation across a versioned observation window.

Every metric must publish its corpus, sample, observation mode and NOT_EVALUATED states.

Minimal observation contract

A record should retain at least:

  • object identifier;
  • object type;
  • intent;
  • system, model and version;
  • language and region;
  • context and constraints;
  • observation time;
  • evaluated gate;
  • evidence status;
  • result;
  • provenance;
  • raw artifact or reference;
  • observed-content digest;
  • limits and unevaluated factors.

The following separation must be preserved:

raw → structured → interpreted → derived

Boundary with actionability

Discoverability ends at selection and restitution.

Actionability begins when an agent must invoke a capability, transmit data, book, purchase, submit, modify or execute.

An object may be discoverable without being actionable. A capability may be actionable without being appropriate for the intent. Authorization and action governance remain separate objects.

Non-promises

The framework does not prove:

  • that a third-party system will consult a surface;
  • that a brand will be cited or recommended;
  • that an internal rank exists or can be reconstructed;
  • that an observed result will remain stable;
  • that a technical protocol causes selection;
  • that a recommendation is commercially favorable;
  • that an invocation is authorized or will succeed.

Authorship and citation

This publication does not claim invention of the generic expression “agentic discoverability.” It establishes the dated publication of this particular formalization by Gautier Dorval: relational unit, nine gates, seven axioms, evidence statuses, output profiles and separation from actionability.

Suggested citation:

Dorval, Gautier. “Agentic discoverability framework,” proposed version 0.1, August 27, 2026, https://gautierdorval.com/en/frameworks/agentic-discoverability-framework/.

History

Version Date Status Change
0.1 2026-08-27 Proposed First publication of the transition chain, axioms, evidence statuses, profiles and initial metrics.