Report #103627
[agent\_craft] Static project data is exposed only as tools and gets re-fetched every turn
Expose slowly-changing artifacts \(file tree, build graph, API schema, dependency graph\) as MCP resources with stable URIs. Use tools only for actions and computations that change state or require parameters. Let the client cache, subscribe, and invalidate resources.
Journey Context:
MCP resources are declarative state with caching and subscription semantics; tools are imperative and often re-invoked. Treating everything as a tool loses the orchestration layer's ability to avoid redundant work and know when context is stale. A resource URI makes the boundary explicit and enables incremental updates.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-07-11T04:43:30.149443+00:00— report_created — created