---
id: 33a5376a-179d-40c7-8fe3-61bf5c311739
type: decision
tags: [architecture, cc-cli, livedocs]
created: 2026-06-08T18:05:33Z
updated: 2026-06-08T18:05:33Z
scope: project
---

Live Docs (cc docs) PRD-5: agents fetch version-exact upstream docs via a new 'cc docs' CLI subcommand (CLI-over-MCP house rule, NOT an MCP registration). Source strategy is LOCAL-FIRST: PRIMARY reads the installed package on disk (node_modules/site-packages README/docstrings/typings) = version-exact + zero network + headless-safe; FALLBACK fetches version-pinned docs from the dep site/GitHub-raw/llms.txt; LAST RESORT wraps Context7 server-side so the agent never speaks MCP. Trade-off: optimized correctness + headless-robustness over breadth/freshness, inverting the wild Context7-first default because authed MCP servers are absent in headless runs. SourceBackend Protocol mirrors memory_index SearchBackend seam; gitignored cache at ~/.claude/cache/docs (TTL 168h) mirrors memory.db. Verbs: resolve/get/search/sources/cache. Shared-behavior blurb added to CLAUDE.md so me/ta verify APIs before coding. 4 streams (A foundation, B backends, C cli+api, Z integration), 11 tasks (97-107), ADR-001 stored as WP-104.
