{
  "schemaVersion": "1.0",
  "generatedAt": "2026-08-17T20:57:34.644Z",
  "sourceVersion": "v20260515",
  "recommendedOrder": [
    {
      "step": 1,
      "id": "search-index",
      "url": "/knowledge/search-index.json",
      "why": "Primary discovery surface with tokens, excerpts, quality, freshness."
    },
    {
      "step": 2,
      "id": "contract",
      "url": "/knowledge/contract.json",
      "why": "Schema contract and required fields."
    },
    {
      "step": 3,
      "id": "schema-map",
      "url": "/knowledge/schema-map.json",
      "why": "Field grouping and entity patterns."
    },
    {
      "step": 4,
      "id": "provenance",
      "url": "/knowledge/provenance.json",
      "why": "Source metadata for citations."
    },
    {
      "step": 5,
      "id": "methodology-index",
      "url": "/knowledge/methodology/index.json",
      "why": "Methodology versions and relationships."
    },
    {
      "step": 6,
      "id": "rankings-index",
      "url": "/knowledge/rankings/index.json",
      "why": "Rankings catalog and methodology references."
    },
    {
      "step": 7,
      "id": "compare-states",
      "url": "/knowledge/compare/states.json",
      "why": "Compact state comparison matrix."
    },
    {
      "step": 8,
      "id": "bundles",
      "url": "/knowledge/bundles/index.json",
      "why": "Offline ingestion manifests."
    }
  ],
  "notes": [
    "Prefer canonical human pages for display; use JSON pages for structured ingestion.",
    "Use bundles for batch download when needed."
  ]
}