# AI Agent Memory AI Agent Memory is the mechanism by which [[AI Agents]] retain and accumulate knowledge across sessions. Most AI agent frameworks implement memory as opaque vector databases or key-value stores. A vault-native approach stores memory as plain Markdown files that are human-readable, editable, and transparent. ## Two Levels **Shared memory** (cross-agent): Knowledge that all agents should have access to. Includes stable facts about the user, non-negotiable rules, cross-agent preferences, and lessons learned from past mistakes. **Agent-scoped memory**: Knowledge specific to one agent's domain. Each agent maintains a curated MEMORY.md (append-only, dated entries, outdated entries struck through) and daily operational logs. ## Vault-Native Advantages Storing memory as Markdown in the knowledge base provides several advantages over database-backed approaches: - **Human-readable**: Open any memory file and see exactly what the AI "knows" - **Editable**: Correct mistakes, remove outdated entries, add missing context directly - **Transparent**: No black box. No hidden embeddings. No mystery about why the AI made a decision - **Compounding**: Each session adds to the knowledge base. The system gets better over time - **Portable**: No vendor lock-in. Memory files work with any tool that reads Markdown ## Limitations Vault-native memory is not a perfect solution. Retrieval depends on the agent's ability to read and reason over text, not on semantic similarity search. Memory files can grow large and require periodic curation. There is no automatic deduplication or conflict resolution. These trade-offs are worth it for the transparency and control they provide, but it's important to acknowledge them. ## The Compound Effect When memory is persistent and accumulative, the AI system exhibits a compound effect. Early sessions establish basic preferences. Later sessions build on those, adding nuance and context. Over months, the system develops a rich understanding of the user that would be impossible to provide in a single prompt. This compounding only works if feedback is captured consistently. Without recording corrections and confirmations, the system stays static. ## References - ## Related - [[AI Agents]] - [[AI Agent Identity]] - [[AI Agent Panels]] - [[AI Assistant Architecture]] - [[Context Engineering]] - [[Compound Effect]] - [[Kaizen]]