§07 · Patterns of Work

AX

Also called Agent experience

Agent experience: how well a codebase, tool or environment supports an agent that starts each session knowing nothing.

AX, agent experience, is DX with an agent as the user. It asks how easily an agent that starts with an empty context can orient itself, find the right command, verify its own work and stay within the rules of the codebase. Where DX is about a person's day, AX is about a session: everything the agent needs has to be discoverable from inside the environment, because there is no osmosis and no colleague to ask.

Poor AX looks like an agent that is capable in general and clumsy in your repo. It runs the wrong package manager, misses the tests that live in an unusual folder, reinvents a helper that already exists, or ships a change that violates a rule everyone on the team knows and nobody wrote down. The fix is rarely a better model; it's usually a better environment.

The tools of AX are ordinary: an AGENTS.md file that states the commands and conventions, automated checks that fail loudly and fast, tools that reach the systems the task touches, and a repo layout that makes the important things findable. Treat every stumble in an AFK run as an AX bug and fix the environment rather than the prompt. Because the agent is the only one there for most of the run, AX is the support it gets.

In the tools
  • Claude CodeCLAUDE.md, hooks and skills are the main AX surface; /init drafts a first CLAUDE.md from the repo.
  • AntigravityKnowledge items teach the agents your codebase once and reuse it across the fleet.
  • GitHubA clear README, scripts in package.json and CI that mirrors the local checks all raise AX for cloud agents.
In conversation

It spent twenty minutes trying to figure out how we run migrations.

That's an AX problem. One line in AGENTS.md and a make migrate target, and it never happens again.

Related terms
Learn it in the school
Words are the easy part

Course 01 puts every one of these terms to work: you install Claude Code, run the loop, and ship a real project — permission modes, compaction, hooks and all.

Start Course 01 →