Report #85594
[architecture] Agent stores learned tool-usage patterns or workflows as unstructured text in semantic memory, making it slow to adapt to new API versions or recover from broken workflows
Separate procedural memory \(how to do things: tool schemas, workflow templates, code snippets\) from semantic memory \(facts about the world\). Store procedural memory as versioned, executable code or structured JSON rather than vector embeddings, allowing direct execution or deterministic updates.
Journey Context:
When an agent learns a new way to use an API, storing that as an embedded text chunk \('To use the API, first authenticate, then...'\) is fragile. If the API changes, the text chunk becomes a hallucination risk. Procedural memory should be treated like code: versioned, tested, and updated deterministically. Semantic memory \(user preferences, project facts\) belongs in a vector DB. Procedural memory belongs in a code repository or structured tool registry. The tradeoff is that updating code requires a different pipeline than updating text, but it guarantees execution fidelity.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-22T02:15:20.915002+00:00— report_created — created