Interpretable interface
An interpretable interface clearly exposes its visual, structural, and programmatic intentions so that a human, a search engine, or an agent can understand available actions and their consequences.
Short definition
An interface is interpretable when what is visible, what is coded, and what is exposed to machine-readable surfaces tell the same story. The button looks like a button, behaves like a button, and has an accessible name that explains its action. The visible field is connected to its label. A service card clearly associates the object, text, price, CTA, and destination.
What the concept governs
The concept governs coherence between:
- visual hierarchy;
- HTML structure;
- accessibility tree;
- interaction states;
- affordances;
- error and confirmation messages;
- semantic signals and structured data.
An interface can be beautiful without being interpretable. It can also be indexable without being actionable. Interpretability requires signal convergence.
What this concept is not
An interpretable interface is not necessarily a simplistic interface. It can be rich, interactive, and complex, but it should not depend on hidden conventions, mandatory hover effects, temporary states, or opaque components to transmit a critical intention.
Common failure modes
- an element looks like a button without being exposed as an action;
- two competing actions share the same label;
- DOM order does not match the logical order of the path;
- an icon carries the action without an accessible name;
- a form error is visible but not associated with the field;
- the context of an action is separated from the object it acts on.
Governance implication
The governance implication is that interface design becomes an authority layer. If the interface leaves an agent to guess what it should declare, the agent may fill the gaps through inference. The goal is not to remove interpretation, but to reduce the space of free inference.
Reading rule
Use interpretable interface to qualify a page, component, or path. Use agentic navigability when the analysis concerns task completion by an agent.