{
  "name": "AX Principles",
  "description": "Reference library for Agent Experience (AX) system-facing design principles. Covers how products should handle AI agents: discovery, auth, tools, recovery, state, notifications, orchestration, and governance.",
  "url": "https://axprinciples.com",
  "docs": "/llms.txt",
  "actions": [
    {
      "name": "list_principles",
      "method": "GET",
      "path": "/en/principles",
      "description": "Browse all 25 AX system-facing principles with instant search and filters",
      "filters": ["category", "difficulty", "tag"]
    },
    {
      "name": "get_principle",
      "method": "GET",
      "path": "/en/principles/{id}",
      "description": "Get a specific principle by ID (e.g. ax-sys-01-make-your-purpose-machine-readable)"
    },
    {
      "name": "get_principle_markdown",
      "method": "GET",
      "path": "/en/principles/{id}/md",
      "description": "Get the token-efficient markdown twin of a principle"
    }
  ],
  "content": {
    "format": "MDX with YAML frontmatter",
    "markdown_available": true,
    "full_corpus": "/llms-full.txt",
    "agents_md": "/AGENTS.md",
    "bilingual": ["en", "es"],
    "principle_count": 25,
    "categories": [
      "Context and comprehension",
      "Access and identity",
      "Discovery and navigation",
      "Tools and capabilities",
      "Recovery and reliability",
      "Memory and state",
      "Notifications and change",
      "Orchestration and handoff",
      "Observability and governance"
    ]
  },
  "related": {
    "human_facing_ax": "https://uxuiprinciples.com/part-7-agent-experience",
    "ecosystem": "https://uxuiprinciples.com"
  }
}