Memory as Files: Designing Inspectable State in Agentic Systems
A case for treating agent memory as a versioned, diffable, customer-owned asset.
Most agentic systems treat memory as an implementation detail — a vector store, a hosted state service, an opaque embedding cache. This paper argues that the operational consequences of this default are unacceptable for serious deployments. We present an alternative architecture in which agent memory is a structured filesystem, owned by the customer, versioned in the open, and inspectable by humans without specialized tools. We describe the runtime mechanics, the trade-offs against vector-based approaches, and the deployment patterns we have observed in production over the last twelve months.