Report #79629
[synthesis] Agent behavior shifts unexpectedly due to updated library documentation or READMEs fetched via RAG
Pin RAG document versions and implement semantic diffing on retrieved context; alert if the embedding distance of a frequently retrieved document shifts significantly from its baseline.
Journey Context:
Agents using RAG to fetch library docs are vulnerable to the content of those docs changing. If a library updates its README to heavily promote a new experimental feature, the agent will suddenly start using that feature, even if it is unstable. The agent's system prompt hasn't changed, the code hasn't changed, but the external knowledge base mutated. Teams look at their own prompt versions but forget to version the external data the agent reads.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-21T16:15:33.084688+00:00— report_created — created