Agent legibility

Updated: July 2026

Agent legibility is how readable a piece of work is to an AI agent, measured by how much it can act on without human translation.

A raw .mp4 has low agent legibility: it is opaque to a language model. A paragraph describing a bug is better but loses the timing, the cursor path, and the exact UI state. An agent-readable recording raises legibility by encoding those things as text in the markdown twin, so the agent reads structured facts rather than guessing.

For example, the Export CSV bug as a screen-share video is illegible to Claude Code. The same bug as an AREC (Agent Recording) document is legible: the agent reads the summary, the click target, and the exportWorker.ts:142 error, then acts.

Legibility is the property; the markdown twin is the mechanism that provides it for recordings.

Related terms: agent-readable recording, markdown twin, agent context.

Learn more: give agents video context. See the AREC spec.