Skip to content

1.5 Primary source access

1. Focus / PL1-primary-source-access

1.5 Primary source access

agent has first-class access to authoritative documentation for every platform, protocol, and major dependency: Apple dev docs, Swift/language API refs, vendor SDKs, specifications (OCPI / OCPP / OAuth). Must be in agent-consumable form (MCP, indexed markdown, llms.txt) — PDFs and JS-rendered SPAs don't count. Prevents the silent failure mode where agents fall back to training cutoff or web-search blog quality


Levels

Level 0

Agent relies on training cutoff and web search; critical sources are PDFs or JS-rendered SPAs the agent can't parse; frequent silent hallucination

Level 1

Some sources accessible (GitHub READMEs, markdown-native vendors); critical stack components still inaccessible (Apple docs, protocol PDFs); agent falls back to training data with no flag

Level 2

All major stack components have agent-accessible primary sources: MCPs for proprietary docs (swift-docs-mcp, apple-docs-mcp), markdown conversions for specs (ocpp.md, ocpi.md), llms.txt for vendors; agent defaults to primary source over training

Level 3

Source freshness tracked — upstream releases trigger reindex; missing sources auto-flagged when agent encounters them; primary-source retrieval rate measured; training-data-fallback rate trends toward zero


Recipes that advance this criterion

No recipes yet.