{
  "schema_version": "v0",
  "name": "The Agentability Project",
  "url": "https://agentability.io",
  "description": "Open research initiative defining Agent Factors Engineering (AFE) — the 8-principle framework for scoring how usable software is for AI agents.",
  "audit_api": {
    "endpoint": "https://agentability.io/api/public-audit",
    "method": "POST",
    "content_type": "application/json",
    "request_schema": {
      "url": "string — the page URL to audit",
      "email": "string — your email address"
    },
    "response_schema": {
      "success": "boolean",
      "audit_id": "uuid",
      "score": "number (0–100)",
      "principle_scores": "object — scores for each of the 8 AFE principles",
      "report_url": "string — URL to the full report"
    },
    "rate_limit": "3 requests per email address (lifetime)",
    "cost": "free"
  },
  "openapi": "https://agentability.io/openapi.json",
  "machine_readable_surfaces": {
    "openapi": "https://agentability.io/openapi.json",
    "report_api": "https://agentability.io/api/agentable-report?id={uuid}",
    "site_json": "https://agentability.io/index.json",
    "json_variant": "https://agentability.io/?format=json",
    "accept_header": "application/json"
  },
  "principles": [
    "machine_readability",
    "chunking",
    "control",
    "status",
    "defaults",
    "handoffs",
    "shadow_ui",
    "transparency"
  ],
  "tiers": {
    "agent_ready": { "min": 45, "max": 100 },
    "developing":  { "min": 35, "max": 44 },
    "lagging":     { "min": 20, "max": 34 },
    "agent_blind": { "min": 0,  "max": 19 }
  },
  "contact": "hello@agentability.io",
  "data": {
    "storage": "Supabase (EU — Frankfurt)",
    "fields_stored": ["email", "url", "score", "principle_scores", "timestamp"],
    "retention": "indefinite (deletion on request)"
  }
}