# AX Principles

> AX Principles is the canonical reference for Agent Experience (AX) — the discipline of designing products so AI agents can discover, authenticate to, act on, and recover within them.

This site covers the system-facing layer: 25 principles across 9 categories that define what your product owes the machines that now use it. Every principle page has a markdown twin at /{lang}/principles/{id}/md.

## Principles index

- [All principles](/en/principles): Full index with instant search and category/difficulty filters
- [Context and comprehension](/en/categories/context-and-comprehension): AX-SYS-01, 02, 03
- [Access and identity](/en/categories/access-and-identity): AX-SYS-04, 05, 06, 42, 43
- [Discovery and navigation](/en/categories/discovery-and-navigation): AX-SYS-07, 08, 09
- [Tools and capabilities](/en/categories/tools-and-capabilities): AX-SYS-10, 11, 12, 13
- [Recovery and reliability](/en/categories/recovery-and-reliability): AX-SYS-14, 15
- [Memory and state](/en/categories/memory-and-state): AX-SYS-16
- [Notifications and change](/en/categories/notifications-and-change): AX-SYS-17
- [Orchestration and handoff](/en/categories/orchestration-and-handoff): AX-SYS-18, 19
- [Observability and governance](/en/categories/observability-and-governance): AX-SYS-20, 21, 22, 44

## Key principles

- [AX-SYS-01](/en/principles/ax-sys-01-make-your-purpose-machine-readable): Make your purpose machine-readable
- [AX-SYS-02](/en/principles/ax-sys-02-serve-a-markdown-version-of-key-content): Serve a markdown version of key content
- [AX-SYS-07](/en/principles/ax-sys-07-publish-a-capability-index): Publish a capability index agents can find
- [AX-SYS-11](/en/principles/ax-sys-11-tool-descriptions-for-the-model): Write tool descriptions for the model, not the human
- [AX-SYS-12](/en/principles/ax-sys-12-tool-descriptions-as-trust-boundary): Treat tool descriptions as a trust boundary

## Resources

- [Full corpus](/llms-full.txt): All 25 principles as a single markdown document
- [Artifacts](/en/artifacts): Copy-paste implementation artifacts for every principle
- [Capability manifest](/.well-known/agent-capabilities.json): Machine-readable site capabilities
- [AGENTS.md](/AGENTS.md): Agent-facing guide to this repository (dogfoods AX-SYS-01/02)
- Per-principle markdown twins at /{lang}/principles/{id}/md

## Related

- [uxuiprinciples.com](https://uxuiprinciples.com): Human-facing AX and the full UX/UI principles ecosystem