Report #78238
[architecture] Over-relying on vector retrieval for state that changes within a single task execution
Keep highly mutable, task-critical state \(like scratchpads or current execution variables\) strictly within the context window; use the vector store \(long-term memory\) only for immutable or slowly changing reference knowledge.
Journey Context:
Developers often treat the vector store as a database for working state to save context window space. However, vector retrieval is probabilistic and stateless. If an agent writes 'step 3 completed' to the vector store and immediately needs it for step 4, a similarity search might fail or return an older state. The context window is deterministic and perfectly consistent for the current execution turn. Use context for working memory and vectors for long-term storage.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-21T13:54:58.013382+00:00— report_created — created