Agentic Systems · Framework
A public framework and live audit tool for measuring whether software is understandable and operable by AI agents. Introduced Agent Factors Engineering — a new design discipline for the agentic era.
AI agents are increasingly being asked to operate software — navigate interfaces, extract information, take actions, complete tasks. But most software was designed assuming the operator has eyes, a mouse, and a mental model built from decades of interacting with visual interfaces. Agents have none of these.
When an AI agent fails to complete a task in a software system, where does the failure originate? In the agent? Or in the software that was never designed to be agent-operable?
Agentability.io is a research project built to investigate that question and produce a framework for answering it.
I coined the term Agent Factors Engineering (AFE) to name the discipline this research points toward. It is the agentic-era successor to Human Factors Engineering — the same structural question applied to a new class of operator.
HFE asked: what does the human need to understand and operate this system? AFE asks: what does the agent need to understand and operate this system? The questions are structurally identical. The answers are different — because agents parse rather than read, query rather than navigate, and fail from ambiguity and structural inconsistency rather than cognitive load.
AFE produces 8 principles for agent-era software design. Full framework on the Frameworks page →
The live tool at agentability.io accepts a URL and returns an Agentability Score (0–100) across the 8 AFE principles. The pipeline:
Beyond the audit tool, agentability.io publishes the Agentability Index: a ranking of approximately 100 widely-used software products evaluated against the AFE rubric. The Index is the research artifact — it makes the state of the industry legible at a glance.
The finding so far: most production software scores in the Lagging tier (20–34). Very few products score in the Developing range. Agent-Ready software is rare. This is the baseline against which the discipline of AFE will be measured as the agentic era develops.
Agentability is not a website audit tool. It is not a competitor to Lighthouse or axe. It is a design research project investigating what software becomes in a world where AI agents are primary operators, not assistants.
The audit tool is a means of generating data. The AFE framework is the contribution. The Agentability Index is the evidence that the framework surfaces real patterns across real software at scale.
Self-hosted on a Hetzner CX23 server (2 vCPU, 4GB RAM). n8n orchestrates the audit workflow. A Dockerised Playwright container handles crawling. Supabase stores audit results. The public gateway runs at n8n.icuboid.in/webhook/public-audit.
Running this on constrained infrastructure is intentional — it demonstrates that serious research infrastructure doesn't require enterprise cloud spend, and it forces me to understand every constraint in the system I'm studying.
The tiers
Live site
agentability.io →
Run an audit on any URL