# Everything on Agent Experience, in one place

> Explore every Agent Experience page: foundations, topics, worked examples, the evidence register, ax-check rules, resources and public work.

Section: Site directory  
Canonical: https://agentexperience.tech/explore/

Every guide, example, resource, rule and evidence record, grouped by what you want to do.

Each circle is a topic. The map puts its guides, rules and evidence records around it.

[Open the map](https://agentexperience.tech/map/)

## What do you want to do?

- [Learn the basics](https://agentexperience.tech/explore/#topic-foundations): What AX is, the map of the field, and the word list.
- [Fix a tool or API](https://agentexperience.tech/explore/#topic-tools): Tool descriptions, large catalogues and APIs, instructions that stay true.
- [Design approvals and handoffs](https://agentexperience.tech/explore/#topic-workflows): Approval steps, handoffs to a person, and recovery after a failure.
- [Measure and review](https://agentexperience.tech/explore/#topic-evaluation): The readiness rubric, metrics, and how to run a review.
- [Talk to the author](https://agentexperience.tech/explore/#work): About, services, contact and support.

## Understand the field

Start with the overview, then choose a topic below.

- [Guide library](https://agentexperience.tech/insights/)
- [The site as a map](https://agentexperience.tech/map/)
- [Field map and lifecycle](https://agentexperience.tech/research/)
- [A practical approach](https://agentexperience.tech/method/)
- [AX glossary](https://agentexperience.tech/glossary/)

## Go deeper by topic

### [Start here](https://agentexperience.tech/insights/topics/foundations/)

- [What is Agent Experience?](https://agentexperience.tech/insights/what-is-agent-experience/)
- [An Agent Experience (AX) framework](https://agentexperience.tech/insights/agent-experience-framework/)
- [Five meanings of agent experience](https://agentexperience.tech/insights/meanings-of-agent-experience/)
- [What does an AX engineer do?](https://agentexperience.tech/insights/what-does-an-ax-engineer-do/)

### [Discovery and documentation](https://agentexperience.tech/insights/topics/discovery/)

- [Build websites agents can understand](https://agentexperience.tech/insights/agent-friendly-websites/)
- [Write agent-readable documentation](https://agentexperience.tech/insights/make-documentation-legible/)
- [AX, UX, DX, and GEO: where each fits](https://agentexperience.tech/insights/ax-vs-ux-dx-geo/)
- [Does llms.txt actually work?](https://agentexperience.tech/insights/state-of-llms-txt/)
- [The state of agent-web standards](https://agentexperience.tech/insights/agent-web-standards/)
- [Agentic Resource Discovery, implemented](https://agentexperience.tech/insights/agentic-resource-discovery/)
- [Let agents start before anyone signs up](https://agentexperience.tech/insights/let-agents-start-before-sign-up/)

### [Tools and interfaces](https://agentexperience.tech/insights/topics/tools/)

- [Write tool descriptions an agent can act on](https://agentexperience.tech/insights/tool-descriptions/)
- [Agent tool catalogues need a pruning strategy](https://agentexperience.tech/insights/agent-tool-catalogs/)
- [An agent dashboard should show the next decision](https://agentexperience.tech/insights/show-the-next-decision/)
- [How to expose a 3,000-operation API to agents](https://agentexperience.tech/insights/large-api-surfaces-for-agents/)
- [Keep agent instructions true](https://agentexperience.tech/insights/keep-agent-instructions-true/)

### [Workflows, trust, and recovery](https://agentexperience.tech/insights/topics/workflows/)

- [Agent workflow design: scoping the first one](https://agentexperience.tech/insights/start-with-workflows/)
- [Agent context handoff: carry the reason for the work](https://agentexperience.tech/insights/preserve-context-through-handoffs/)
- [Human approval workflows for AI agents](https://agentexperience.tech/insights/approval-is-a-workflow/)
- [Agent error recovery: design the path back](https://agentexperience.tech/insights/design-for-recovery/)
- [Record retries as product history](https://agentexperience.tech/insights/retries-are-product-history/)
- [Approval, handoff and recovery patterns for AI agents](https://agentexperience.tech/insights/approval-handoff-recovery-patterns/)

### [Evaluation and improvement](https://agentexperience.tech/insights/topics/evaluation/)

- [The Open Agent-Readiness Rubric](https://agentexperience.tech/insights/agent-readiness-rubric/)
- [Evaluate the decisions in an agent workflow](https://agentexperience.tech/insights/evaluating-agent-workflows/)
- [How do you measure agent experience?](https://agentexperience.tech/insights/measure-agent-experience/)
- [Run an Agent Experience review](https://agentexperience.tech/insights/run-an-ax-review/)
- [Agent evaluation loop: run, judge, triage, fix, repeat](https://agentexperience.tech/insights/build-a-reliable-agent-evaluation-loop/)
- [Agent readiness scores compared](https://agentexperience.tech/insights/agent-readiness-scores-compared/)
- [Agent experience examples you can check](https://agentexperience.tech/insights/agent-experience-examples/)

## Put it into practice

Follow a worked example or take a template into your own project.

- [Worked examples](https://agentexperience.tech/examples/)
- [Capability and authority preflight before action](https://agentexperience.tech/examples/capability-authority-preflight/)
- [Timeout recovery: verify before retry](https://agentexperience.tech/examples/timeout-recovery-verify-before-retry/)
- [All resources](https://agentexperience.tech/resources/)
- [Workflow review brief](https://agentexperience.tech/resources/workflow-review-brief/)
- [MCP tool-description test cases](https://agentexperience.tech/resources/mcp-tool-description-test-cases/)

## Follow the evidence

Dated changes, the findings behind the guides, and the rules of a checker for agent-facing surfaces.

- [What changed in AX](https://agentexperience.tech/changes/)
- [AX evidence register](https://agentexperience.tech/evidence/)
- [ax-check rules](https://agentexperience.tech/checks/)
- [What changed in AX, RSS](https://agentexperience.tech/changes/rss.xml)
- [What changed in AX, JSON feed](https://agentexperience.tech/changes.json)
- [Evidence register JSON](https://agentexperience.tech/evidence.json)

## Every ax-check rule

### D: descriptions and schemas

- [Missing description](https://agentexperience.tech/checks/axc-d001/)
- [Placeholder description](https://agentexperience.tech/checks/axc-d002/)
- [Description only restates the name](https://agentexperience.tech/checks/axc-d003/)
- [Does not say when to use it](https://agentexperience.tech/checks/axc-d004/)
- [Does not say when not to use it](https://agentexperience.tech/checks/axc-d005/)
- [No neighbouring tool named](https://agentexperience.tech/checks/axc-d006/)
- [Closed vocabulary hinted in prose, not declared as an enum](https://agentexperience.tech/checks/axc-d007/)
- [Parameter has no description](https://agentexperience.tech/checks/axc-d008/)
- [Side-effect annotation contradicts the description](https://agentexperience.tech/checks/axc-d009/)
- [No side-effect annotations](https://agentexperience.tech/checks/axc-d010/)
- [openWorldHint false for a tool that reaches outside](https://agentexperience.tech/checks/axc-d011/)
- [Object schema does not set additionalProperties to false](https://agentexperience.tech/checks/axc-d012/)
- [Near-duplicate descriptions](https://agentexperience.tech/checks/axc-d013/)
- [Duplicate name](https://agentexperience.tech/checks/axc-d014/)
- [Description too short](https://agentexperience.tech/checks/axc-d015/)
- [Description length outlier](https://agentexperience.tech/checks/axc-d016/)
- [Context footprint estimate](https://agentexperience.tech/checks/axc-d017/)
- [Required property not defined](https://agentexperience.tech/checks/axc-d018/)
- [Example does not match the schema](https://agentexperience.tech/checks/axc-d019/)
- [Promotional language in a description](https://agentexperience.tech/checks/axc-d020/)
- [Many visible parameters](https://agentexperience.tech/checks/axc-d021/)
- [SKILL.md frontmatter missing or invalid](https://agentexperience.tech/checks/axc-d022/)
- [Skill name breaks the naming rules](https://agentexperience.tech/checks/axc-d023/)
- [Skill description over 1,024 characters](https://agentexperience.tech/checks/axc-d024/)
- [Bundled reference missing](https://agentexperience.tech/checks/axc-d025/)
- [SKILL.md over 500 lines](https://agentexperience.tech/checks/axc-d026/)

### C: CLI behaviour

- [Command hangs without a terminal](https://agentexperience.tech/checks/axc-c001/)
- [Error exits with status 0](https://agentexperience.tech/checks/axc-c002/)
- [Error text not on stderr](https://agentexperience.tech/checks/axc-c003/)
- [Error does not name a next step](https://agentexperience.tech/checks/axc-c004/)
- [Unknown command gives no suggestion](https://agentexperience.tech/checks/axc-c005/)
- [No machine-readable output flag](https://agentexperience.tech/checks/axc-c006/)
- [Documented JSON output does not parse](https://agentexperience.tech/checks/axc-c007/)
- [No dry-run flag documented](https://agentexperience.tech/checks/axc-c008/)
- [Help is not reachable](https://agentexperience.tech/checks/axc-c009/)
- [ANSI colour codes without a terminal](https://agentexperience.tech/checks/axc-c010/)
- [NO\_COLOR not honoured](https://agentexperience.tech/checks/axc-c011/)
- [Version output is not plain](https://agentexperience.tech/checks/axc-c012/)
- [Advertised JSON output not verified](https://agentexperience.tech/checks/axc-c013/)

### F: drift and facts

- [Claimed URL is broken](https://agentexperience.tech/checks/axc-f001/)
- [Claimed URL could not be verified](https://agentexperience.tech/checks/axc-f002/)
- [Claimed npm package does not exist](https://agentexperience.tech/checks/axc-f003/)
- [Claimed PyPI package does not exist](https://agentexperience.tech/checks/axc-f004/)
- [Claimed package version does not exist](https://agentexperience.tech/checks/axc-f005/)
- [Claimed MCP tool is not served](https://agentexperience.tech/checks/axc-f006/)
- [Served MCP tool is not mentioned](https://agentexperience.tech/checks/axc-f007/)
- [Claimed CLI command does not exist](https://agentexperience.tech/checks/axc-f008/)
- [Claimed CLI flag does not exist](https://agentexperience.tech/checks/axc-f009/)
- [Linked local file is missing](https://agentexperience.tech/checks/axc-f010/)
- [Claims extracted but not verified](https://agentexperience.tech/checks/axc-f011/)

## Every evidence record

- [An enum in the schema ends silent failures from example-only vocabularies](https://agentexperience.tech/evidence/ev-0001/)
- [Constraints stated only in prose produce silent failures on live APIs](https://agentexperience.tech/evidence/ev-0002/)
- [Error text that names the next tool lifts recovery](https://agentexperience.tech/evidence/ev-0003/)
- [Naming recovery tools is the active ingredient in failure receipts](https://agentexperience.tech/evidence/ev-0004/)
- [Idempotency keys cut duplicate writes from 28% to 4%](https://agentexperience.tech/evidence/ev-0005/)
- [An evidence contract cuts false-success reports after tool failures](https://agentexperience.tech/evidence/ev-0006/)
- [Browser agents declare success on most of their failures](https://agentexperience.tech/evidence/ev-0007/)
- [Declared completion and logged completion differ by up to 41 points](https://agentexperience.tech/evidence/ev-0008/)
- [Tools as code match or beat JSON tool calls for most models](https://agentexperience.tech/evidence/ev-0009/)
- [Agent scaffolding, not MCP versus CLI, drove cost](https://agentexperience.tech/evidence/ev-0010/)
- [Coding agents mostly read instruction files, not docs sites](https://agentexperience.tech/evidence/ev-0011/)
- [Compact documentation did not help when the source was present](https://agentexperience.tech/evidence/ev-0012/)
- [FAQ blocks and structured data showed no citation effect within a domain](https://agentexperience.tech/evidence/ev-0013/)
- [Allow/ask/never policies blocked less overreach than per-action approval](https://agentexperience.tech/evidence/ev-0014/)
- [Approvals that outlive their task raise attack success](https://agentexperience.tech/evidence/ev-0015/)
- [Approval records omit the effects a command goes on to trigger](https://agentexperience.tech/evidence/ev-0016/)
- [Injected skills lowered pass rates and raised token cost on average](https://agentexperience.tech/evidence/ev-0017/)
- [Skill rules that name a command or path change what agents do](https://agentexperience.tech/evidence/ev-0018/)
- [Skill selection precision collapses as the skill pool grows](https://agentexperience.tech/evidence/ev-0019/)
- [Praise and list order move tool selection](https://agentexperience.tech/evidence/ev-0020/)
- [Agents leave available tools unused: the adoption gap](https://agentexperience.tech/evidence/ev-0021/)
- [Search-and-execute meta-tools cut catalogue tokens by 99% in production](https://agentexperience.tech/evidence/ev-0022/)
- [Hiding tools is not enforcing permissions](https://agentexperience.tech/evidence/ev-0023/)
- [Harnesses alter shell calls and the wrong action runs silently](https://agentexperience.tech/evidence/ev-0024/)
- [Run-to-run variance dominates, and a verification tool beats a verification prompt](https://agentexperience.tech/evidence/ev-0025/)
- [Prompt injection split across tool channels evades defences](https://agentexperience.tech/evidence/ev-0026/)
- [A capable agent skipped the index and guessed the page](https://agentexperience.tech/evidence/ev-0027/)
- [A JSON input mode for a CLI raised agent cost 4x to 11x](https://agentexperience.tech/evidence/ev-0028/)
- [A warning that names the failing plan redirected agents; a tip did not](https://agentexperience.tech/evidence/ev-0029/)
- [Adding the context7 MCP server gave no lift; its tools went unused](https://agentexperience.tech/evidence/ev-0030/)
- [A model with cheaper tokens cost 3.7x more per run](https://agentexperience.tech/evidence/ev-0031/)
- [Vendor claim: agents never invoked a docs skill in 56% of eval cases](https://agentexperience.tech/evidence/ev-0032/)
- [Vendor claim: agents were 48% of Wrangler CLI use](https://agentexperience.tech/evidence/ev-0033/)
- [Vendor claim: users approved about 93% of permission prompts](https://agentexperience.tech/evidence/ev-0034/)
- [Vendor claim: 70% of new Supabase databases are created by agents or AI tools](https://agentexperience.tech/evidence/ev-0035/)
- [A CLI exits 0 when a destructive command is refused](https://agentexperience.tech/evidence/ev-0036/)
- [Destructive and bulk commands that report success but do nothing](https://agentexperience.tech/evidence/ev-0037/)
- [Dry-run output printed secrets until a fix redacted them](https://agentexperience.tech/evidence/ev-0038/)
- [Launch post and documentation disagree on agent output format](https://agentexperience.tech/evidence/ev-0039/)
- [Agent skills recommended a package that does not exist](https://agentexperience.tech/evidence/ev-0040/)

## Explore the work and get in touch

See the public work, read about its author, or talk about a workflow.

- [Selected public work](https://agentexperience.tech/work/)
- [About Himadri](https://agentexperience.tech/about/)
- [Services and engagement paths](https://agentexperience.tech/services/)
- [Contact](https://agentexperience.tech/contact/)
- [Support and MCP limits](https://agentexperience.tech/support/)
- [Privacy](https://agentexperience.tech/privacy/)
- [Terms of use](https://agentexperience.tech/terms/)
- [Search the site](https://agentexperience.tech/search/)

## Use the site with an assistant

Connect an MCP client, or fetch the machine-readable files directly.

- [MCP setup and capabilities](https://agentexperience.tech/connect/)
- [Agent reading index](https://agentexperience.tech/llms.txt)
- [Full-text guides and examples](https://agentexperience.tech/llms-full.txt)
- [Resource discovery manifest](https://agentexperience.tech/.well-known/ard.json)
- [Readiness rubric JSON](https://agentexperience.tech/agent-readiness-rubric.json)
- [RSS feed](https://agentexperience.tech/rss.xml)