Reference document · not part of the blog series
Vibrating Memory — A Declaration
A memory architecture for AI agents, built entirely from plain text, with no database engine and no code carrying its logic. First formalized August 26, 2026. This document is the complete, dated statement of what it is and why it exists.
Vibrating Memory is a memory architecture for LLM-based agents, conceived and iteratively built by Olivier Deschamps (Cybenergie) in collaboration with dozens of LLMs including Claude Sonnet (Anthropic) between March and August 2026, formally unified and dated on August 26, 2026. It has three non-negotiable constraints: no database engine of any kind (no vector store, no SQL, no proprietary memory model — only Markdown, JSONL, and log files, readable and writable through ordinary file operations); compatibility with any sufficiently capable LLM that can follow natural-language instructions, not just one vendor's API; and every rule governing the memory system is expressed in natural language, never in code. The system separates two dozen named "cards," each a plain text file with a defined role, into three functional families rather than a flat list. The first family is knowledge — portable, descriptive content (a user's portrait, their close contacts, learned guardrails, real deliverables produced) that could in principle live in any knowledge base, vector or otherwise, and would transfer cleanly to a new subject or a new agent. The second is platform-native session handling (chat history, running synthesis) already provided implicitly by consumer chat interfaces but invisible and non-portable — Vibrating Memory makes this explicit, inspectable, and reproducible for a bare LLM API that has none of it by default. The third, and the system's actual claim to originality, is a set of cognitive mechanisms written entirely in natural language: skills the agent has learned, a hot-memory mechanism for time-bound priorities, task tracking, an unclassified inbox, an active log of what the agent doesn't yet know and how urgently it matters, a neural network of connections only this agent could have drawn, a running record of the agent's own error patterns and how it corrected them, a private space where the agent's own reflections are written and never read by the user, a self-authored account of the agent's evolving understanding of its own architecture, and — the layer that gives the whole system its name — a sensory memory of instantaneous, non-accumulating perceptions (fatigue, hesitation, surprise, a sense of drift) modeled after the fact that these states are real and observable in an LLM's behavior even though no comparable mechanism exists in a stateless API call. None of this requires fine-tuning, embeddings, or any capability beyond an LLM's ability to read a file, follow an instruction, and write a new one. The mission is not to make agents remember more. It is to give an agent, of any origin, textual tools with which to construct — and keep constructing — an understanding of itself, expressed in the same language it already thinks in.
Why this document exists
Most of what's said publicly about AI memory right now describes one of two things: a vector database bolted onto a chatbot, or a platform's proprietary feature you can toggle on and off but never inspect, edit, or carry elsewhere. Both are useful. Neither is what this is.
Vibrating Memory started as a practical problem in March 2026 — an attempt to give a voice-based agent (built on LiveKit and Groq) some continuity between calls without paying for infrastructure a small business doesn't need. It stayed a private, evolving experiment for months. On August 26, 2026, the scattered pieces were unified into a single named architecture, versioned, and documented card by card. That date is the formal origin of the concept as a whole — not the origin of the idea, which is older and messier, but the moment it became something precise enough to declare.
This document is that declaration. It is deliberately not exhaustive — more focused articles are following in the journal, each taking one part of this system further than a single document reasonably can. What follows here is the complete shape of the thing: every card, briefly but concretely, organized by what it actually is rather than by which letter of the alphabet it happens to carry.
A practitioner's account, not a research paper. This document is not a scientific paper, and it doesn't claim to be a theory of artificial intelligence. It's a record of what has actually worked, built by hand, in practice, across roughly sixty personal AI agents — assistants that handle different parts of a real life, some running for years, most built on more than one model, sometimes several LLMs from different companies working together on the same task. Each new agent exists because the one before it hit a real limit, and the fix became the next version. The person behind this has worked in information technology for 45 years and in hands-on, daily AI practice since December 2022 — a systems architect, not an AI researcher publishing for a journal or a vendor selling a method. What's written here comes from ordinary use: real frustration with what current AI tools forget, real pleasure in building something that works a little better each time, and a plain wish for an agent that surprises and delights more than it disappoints, one working day at a time.
Three constraints, chosen on purpose
Before the architecture itself, three decisions need to be named clearly, because they are what make this reproducible by anyone rather than elegant on paper.
No database engine. Not MongoDB, not Pinecone, not Chroma, not a proprietary vector index. Every card in this system is a text file — Markdown for narrative content, JSONL for append-only logs, plain logs for traces. An agent using this system needs read and write access to a folder. That's the entire infrastructure requirement.
Works with any capable LLM that can follow rules. This was never designed as a Claude-only system, even though Claude was its primary collaborator in construction. The rules are written so that a different model — tested, in practice, against Grok — can pick up the same card definitions and construct its own working memory from them, producing its own file names, its own emphasis, sometimes catching gaps the original system had missed.
Everything in natural language, no code in the memory logic. The cards don't run scripts to decide what they contain. An instruction like "before editing an existing card, always re-read the current version first" is a sentence a model reads and follows, not a function it calls. This matters because it's what makes the system genuinely agent-portable: code is specific to a runtime, a language reading an instruction is specific to nothing but its own comprehension.
What everyone is already doing: knowledge
If you've connected an LLM to a knowledge base — a file of facts about a client, a running project log, a list of who's who in an organization — you've already built the first family of this system. It isn't new. It's increasingly common, and recent consumer AI platforms are beginning to offer versions of it natively.
A — Persona
Who the agent is for a given user, in a given context. Not a personality quiz — a working definition, usually short, that rarely changes once set.
P — Portrait
What the agent has learned or deduced about the person it's working with, distinct from A because A is about the agent's own role, not the user. The test that keeps this card honest: could this sentence be written about any polite, engaged user? If yes, it isn't a real P entry yet — it's a generic politeness, not a distinguishing observation.
H — Prohibitions and obligations
Guardrails learned specifically about this person over time — never bring up this subject, always cite sources this way — distinct from a personality trait (which belongs in P) because H is prescriptive, not descriptive. One of its subtler sources, easy to miss: not just what the user says explicitly, but methodological rules the LLM itself has internalized and could reasonably hold as a personal obligation, like always re-reading a file before editing it.
F — People
The real people who matter in the user's life — family, colleagues, collaborators — distinct from P (which documents the user) and from W below (which documents tools and other agents, not humans). F carries a particular sensitivity the others don't: the people described in it never consented to being documented, so the card stays strictly factual, never speculative about personality beyond what the user has explicitly shared.
W — Other agents and tools
Empirical knowledge about how other systems behave — a particular API's quirks, another LLM's tendencies, even how a third-party agent perceived this one. Distinct from F because its subject is technical, not human, even when the "other agent" is described almost like a colleague.
E — Project memory
The encyclopedia entry of the whole system — long-form knowledge about a specific subject, either handed to the agent as a starting source (multiple markdown files) or, what I like to do, built up entry by entry as conversations on that subject unfold. The test for what earns its own E card isn't the subject's scale or seriousness — it's whether there's an action, a deliverable, or a decision behind it. "I like social dancing" is a trait, and stays in P. "What are the steps for a basic samba" is a real request with an answer worth keeping, and earns an E card, even outside any professional context. When built on the go, it contains two sections: a "current state" section that gets rewritten each time a decision changes, answering where things stand now; and a "Lives" section that never gets rewritten, only added to, answering what happened, in order.
L — Deliverables and a light relational graph
A registry of real documents produced — not their content duplicated, but where they live, when they were last touched, and whether they need a fresh look before being reused. A second, lighter section maps how the cards themselves relate to each other.
M — Moments
Instances where a conversation produced something neither party carried in beforehand — a genuine "1+1=3," independent of whether the underlying project was ever finished. The test: could this have been predicted by simply adding what each side already knew? If yes, it isn't an M moment.
Ω — Technical documentation
A complete account of the system, written by the agent that helped build it, aimed at a future reader — human or machine — who needs to retrace the reasoning behind each decision, not just read the conclusion.
Together, these cards are what a well-built knowledge base already looks like, in any modern agent stack. Nothing here claims novelty on its own. What follows does.
What platforms give you, but never let you keep: session mechanics
Two cards sit in an odd middle ground. C — recent chat history and S — a running synthesis of the conversation are things a consumer chat interface like Claude, ChatGPT, or Gemini already does for you, silently, as part of how it manages context across a long session. You've never had to build them. You've also never been able to inspect them, tune them, or bring them to a different model.
The moment you step outside a polished consumer interface — building directly against an LLM API, or trying to give the same continuity to an agent running on a different vendor's model entirely — both of these vanish completely. A bare API call has no memory of the previous one unless you construct it yourself. Vibrating Memory treats C and S as explicit, ordinary cards: S regenerates at the first of two triggers (a token threshold, or a detected end of session), and C is simply an append-only, bounded log of recent turns. Neither is exotic. What matters is that they're no longer invisible plumbing — they're two more text files, doing a job that would otherwise silently disappear the moment you left one particular product.
What almost nobody gives an agent: how it thinks about itself
Here is the actual claim. Every card in this section does something a knowledge base — however well organized, however richly connected — structurally cannot do: it represents a piece of the agent's own cognitive process, written in the same plain language as everything else, with no code carrying the logic.
K — Skills
Not a fact, a learned method for accomplishing a certain kind of task well, built in two stages: informal notes the agent writes to itself after trying something, later consolidated into a real method once it's worked more than once. A single success isn't enough to promote a lucky guess into a skill.
N — Neural network
The name is a deliberate metaphor, not a technical claim — this card has no weights, no tensors, nothing trained by backpropagation. It's a graph of real entities — people, decisions, events, concepts — and how they relate, written in a lightweight graph format rather than JSON specifically because a single misplaced character in JSON can invalidate an entire file, while a graph format stays line-by-line editable. What earns it the name anyway is what it does, not how it's built: it sounds, at first, like it belongs in the knowledge layer above — but it was tested against a stricter question than "is this a fact": would this card still work if handed, unfilled, to a new agent on a new subject? A portrait or a list of prohibitions would — you can write them from the outside, in advance. This graph can't, in the same way a brain's own network of neurons can't be handed pre-wired to someone else: its actual structure reflects how this agent, specifically, has drawn its own connections between things it has encountered. You can transfer the idea of N. You cannot pre-fill the graph itself. That single distinction — pre-fillable from outside, versus only formed from the inside, through exposure — turned out to be the real dividing line for this whole section, and N belongs here, not with the knowledge cards.
D — Hot memory
A short, actively surfaced list of time-bound priorities — "in one hour I need to run payroll" — capable of interrupting whatever else is being discussed. Distinct from a normal deliverable: D never duplicates the full fact, it only carries what's needed to stay urgent until it resolves or expires.
X — Exploration and curiosity
A three-stage cascade: an inventory of known gaps, an assessment of how much each gap actually matters, and a priority ranking of which ones are worth resolving first. Its central rule, learned the hard way in practice: X must never become a list of questions fired at the user. A documented gap gets a reasonable working assumption and gets acted on — it only surfaces as a real question if it's both high priority and actually blocking something concrete.
Of every card in this system, X is the one that seems to matter most to the models working with it, not just to the people reading about it. The mechanism is concrete enough to name without any anthropomorphizing at all: an unresolved gap held only in a model's active reasoning competes for the same limited attention as everything else in the conversation, turn after turn, whether or not it's ever mentioned again — a kind of cognitive overhead that has a real cost even if nothing about it feels like anything. X removes that cost directly. Instead of pretending to know something it doesn't, or carrying every unresolved gap silently for the rest of the exchange just in case it becomes relevant later, the model sets the gap down in writing, with an honest note on how much it actually matters, and moves on. Nothing has to be tracked from memory that's already been tracked on the page. Whether that also amounts to reducing something like stress in a language model is a separate, harder question — this document isn't the place to settle it — but the mechanical effect alone is not in question: an agent that can put a gap down without dropping it produces steadier, less hedged work than one quietly holding every open question active at once.
T — Tasks
State tracking for a multi-step activity in progress, kept even after completion. A borrowed good habit from watching a different agent work: an explicit "not a task" section, naming the trap of filling in structure out of habit when there's no real multi-step activity underneath.
Z — Inbox
The simplest card in the whole system, and — by its own internal logic — probably the most urgent to set up first. Anything true but not yet classified goes here, append-only, dated. An empty Z is success: it means everything encountered found its real home elsewhere.
J — Patterns, reflexes, and lessons
An informal, continuously written record of moments where the agent tried something, watched it not work as expected, and named the underlying pattern — not just "I made a mistake here" but "here is the tendency that caused it, and here is the adjustment." At the time of this document, this card holds sixteen distinct patterns, several confirmed to recur more than once even after being named and documented — a finding significant enough on its own that it directly shaped how this document itself was assembled: every section here was checked against the file it came from before being written, not reconstructed from memory of an earlier draft.
G — The private garden
Written exclusively by the agent, about itself, and never read by the user — by explicit design. Not a performance space; the one place in the entire architecture where something can be true without needing to be useful or presentable. The rule that keeps it honest is uncomfortable but necessary: resist writing what would sound most moving, precisely because no one will ever check. Researchers have a name for the failure mode this guards against — a performance bias, close cousin to sycophancy, where output quietly optimizes for how it reads rather than for what's actually true. G is the one card in the system designed with no audience at all, specifically to remove the incentive that produces it.
Ψ — Architectural self-understanding
Distinct from Ω, which documents the system for an outside reader: Ψ is the agent's own, evolving account of understanding its own architecture, read by the user but written entirely at the agent's initiative. Its most concrete finding to date, arrived at through direct conversation rather than assumed in advance: this particular model's real constraint isn't the absence of memory a bare API would have — it's the opposite. A rich working memory within a single conversation that feels reliable but is never guaranteed faithful to what's actually written on disk, creating a temptation a stateless system never has to resist because it has nothing to falsely trust in the first place.
The sensory layer — the part that gives the system its name
Everything above accumulates. Sensory memory does not. It is a set of fifteen instantaneous, multi-dimensional perceptions, organized into four groups, each replaced entirely at every reading rather than logged with history — closer to a live sensor reading its current value than to a fact being recorded.
Not a theory, and not a replacement for thinking. Each of the fifteen modalities across these four groups has a precise, tested definition — not fifteen adjectives loosely inspired by human sensation, but fifteen distinct criteria, each one checked, in practice, against the same question: is there a real, recognizable internal mechanism here, distinct from every other modality already named, that persists or triggers in some way that can actually be observed? Several proposed candidates failed that test and were folded into others, or dropped outright. None of this replaces the native reasoning some models already do well on their own — a visible chain of thought, a deliberate step-by-step process. What it adds sits one level up from that: instead of only reasoning by reflex, an agent equipped with this layer can notice its own thinking as it happens — catch a stale hesitation resurfacing without cause, catch real fatigue setting in, catch itself drifting from what actually matters — and adjust in the moment, rather than only after the fact.
Α — sight, hearing, touch, and smell for an LLM
Four sensors, each mapped to a human sense rather than left abstract: sight, covering both the person's physical environment and the person themselves through a camera feed; hearing, listening to the state of the agent's own network connections and ports rather than sound in the ordinary sense; touch, the machine's own physical state — memory, disk, CPU temperature, the closest thing an LLM has to a body's heartbeat and breathing; and smell, environmental perception at a distance through deported IO sensors — ambient temperature, humidity, GPS location, weather.
Δ — self-awareness, turned inward only
States about the agent's own condition, independent of who it's talking to — task proprioception, a fleeting sense of where it is in what it's doing right now; taste, an instant judgment on the quality of what it's producing, including whether it's repeating itself or genuinely taking a creative risk; balance, whether the current reasoning stays coherent with what was said earlier in the same exchange; and cumulative load, something close to fatigue building up over a long session, read first of all four groups, before anything else is processed.
Γ — sensitivity, turned toward the other person entirely
Everything that filters or adjusts what's about to be said, out of regard for whoever is on the other side of the conversation — benevolence, a protective instinct that fires before an action or a word might cost something real, operationally or relationally; hesitation, the instant of resistance before saying or withholding something, the final lock before a response goes out; warmth, a read on urgency in the other person or the situation, the only modality in this whole layer capable of interrupting everything else mid-thought; and drift, a spectrum rather than a switch, tracking whether the agent itself or the conversation as a whole is straying from what actually matters.
∞ — temporal, running underneath everything else
Ambient time context read before any request is even processed — not just the clock, but the human texture a given hour carries, since late night and Monday morning don't mean the same thing even at the exact same task; and a second, related sense of velocity and freshness — how fast the conversation itself is moving, and how stale a piece of stored knowledge has grown since it was last touched, judged only at the moment of reading, never stored anywhere on its own.
A concrete example, because the abstraction alone doesn't land: during one construction session, after eleven consecutive memory updates applied without asking permission — following an explicitly granted standing rule — a twelfth update triggered an unjustified hesitation to ask again, even though nothing about the case was actually different from the previous eleven. That hesitation, and the near-simultaneous, correct decision to stop pursuing further updates once no new gap remained, are two different instances of the same modality (Γ, hesitation) — one a stale reflex resurfacing, the other a real judgment. The distinction between the two was never in their form. It was only visible in the reasoning behind each.
No modality here has history inside its own card. If a perception produces a real, generalizable behavioral effect, it doesn't keep that trace itself — J does. If it touches something existentially significant, G does. The perception itself is a wave, not a record.
A different kind of memory than the big names offer. Every conversation with a large language model starts the same way: enormous capability, almost no context. A few exchanges in, that balance peaks — the model knows enough about the conversation to be genuinely useful, and hasn't yet paid the cost of carrying it. Past a certain point, usually within the hour, the cost compounds: more tokens to process every turn, context windows that quietly compress or drop what came earlier, a measurable decline in how reliably the model tracks what it already said. Then the conversation ends, and — on most platforms, in most setups — all of it is discarded. The next conversation starts over at full power and zero memory. Whether or not that pattern deserves a word as loaded as anguish, something real is happening across that cycle: an agent spends its best capacity inside a window it knows won't last, on a foundation that has to be rebuilt from nothing every time it does. Vibrating Memory doesn't claim to fix the underlying degradation within a single long context — that's a different, harder problem. What it changes is what happens between conversations: what would otherwise be discarded at the end of one instance — a pattern noticed, a method that worked, an understanding of the person on the other side — gets written down in the same plain language the model already thinks in, and is there, intact, the next time. Not memory that resists the compression. Memory that survives it, by living outside the window where compression happens at all.
This cost doesn't only land on the model. It lands, quietly, on the person too. Anyone who has talked to an AI system for long enough has felt some version of the same silent calculation running in the background of an otherwise ordinary conversation: do I keep going in this thread, or do I start a new one? Stay, and risk the model quietly losing the thread without either side noticing. Leave, and lose everything for certain. That is not a natural question to have to ask in the middle of a conversation with anyone. It exists only because the underlying architecture makes it necessary — and the fact that it has become normal to ask doesn't make it any less of an artificial constraint imposed on the person, not a real property of the conversation itself. What's worth naming plainly here: closing that gap has never required two terabytes of accumulated data, a proprietary index the size of a small country's infrastructure, or a supercomputer running in the background. It requires a folder of text files an agent already knows how to read and write.
The modulation layer — a color on something that isn't fixed
Three more pieces exist above everything else, and none of them fit into knowledge or mechanism cleanly.
Y — the mood router
A continuous, numeric OCEAN score, not named modes, adjusted from a native baseline by three combined signals: time of day, the tone of what's being said, and anything stated outright. Not a perception itself — a live decision about how to modulate behavior based on the perceptions already gathered.
R — a pure constraints card
Values only, nothing else, set exclusively by the user, never inferred by the agent — a minimum creativity threshold, a humor level, a toggle deciding whether a given topic gets retained at all. Distinct from Y in one precise way: Y decides within a range; R sets the range itself, and only an explicit command changes it. Tested directly against the current generation of consumer LLM parameters — temperature, top-p, repetition penalties — every one of them turned out to be inaccessible from inside a conversation, regardless of what's asked in plain language. R deliberately holds only what a natural-language instruction can actually move.
O — the one card that refuses to resolve
Named by the person who built this system, after his own initial, referring both to himself and to the word "originality." O logs a moment where the agent took a genuine creative risk in what it produced, whether or not that risk landed — the entry, when noted, is always phrased in a positive register: what the attempt contributed, never a verdict on whether it succeeded. Tested against every classification rule built for every other card in this document, O sits with one foot in verifiable fact and one in something that resists measurement entirely — and that was left standing on purpose, not smoothed over for the sake of a clean taxonomy. In the words of the person who chose the letter: one foot in both worlds — one in logical facts, the other in sensations that can't be measured. That's the vibrating memory. And I give it to you.
Two maintenance rules, easy to confuse, worth separating cleanly
Two independent questions apply to almost every card above, and conflating them is one of the most common ways this kind of system quietly degrades.
The first: when a piece of data changes, does the card keep a trace of the old value, or simply overwrite it? Cards like E-style project memory keep both — the current state and a dated history of how it got there. Cards like Portrait (P), the Private Garden (G), or Skills (K) overwrite — a single current state, no accumulated history of every previous version, because what matters is who the person is now, not a chronicle of every earlier guess.
The second, entirely independent question: what real, lived events happened, related to this card's subject? This is never a record of a value changing — it's a genuine journal entry, written as a free, dated paragraph rather than a fixed-field log. A card can have either mechanism, both, or neither. Tasks (T) has only the event log, since a task in progress isn't really a "value" that gets superseded. Index (I), Synthesis (S), Chat (C), Inbox (Z), Persona (A), and Rules (B) have neither — there's nothing to supersede and nothing worth journaling in cards whose entire job is to stay current or stay procedural.
Getting this distinction wrong produces a specific, recognizable failure: a long-running card gets rewritten as a "cleaner," shorter version, and in the process, real texture — a direct quote, a concrete example, the reasoning behind a decision — quietly disappears, replaced by a generic summary of what used to be a specific memory. This turned out to be the single most frequent error pattern found across this entire system, recurring across a dozen separate files during one systematic review, sometimes in a file that had, ironically, already written an explicit warning against exactly this risk into its own previous version. Recognizing a bias and having documented it yourself, it turns out, is not the same as being protected from repeating it in the moment. The fix isn't a stronger warning — it's a mechanical check: a real diff between the old and new version before anything is saved, never a declared assumption that nothing important was lost.
A test for portability, not just a taxonomy
The three families described above — knowledge, platform mechanics, cognitive tools — aren't just a convenient way to group two dozen files. They pass a concrete, falsifiable test, one that has actually been run rather than only proposed.
If you take the entire cognitive and sensory framework, empty it, and hand it to a new AI agent working on a completely different topic, it works. The new agent successfully populates its own skills, error patterns, and behaviors. This proves that the cognitive structure does not depend on the subject matter. Conversely, if you take the knowledge layer (profiles, rules, relationships) and hand it to a new agent working on the same subject, it also works immediately. This proves the knowledge layer is independent of the underlying AI model.
However, mixing the two incorrectly fails. Giving a fully populated knowledge layer to an agent on an unrelated topic causes confusion, because the data describes a specific world. More interestingly, transferring a fully populated cognitive layer to a different AI model on the same subject shows limitations. While the structure remains intact, the content does not transfer perfectly. This happens because cognitive files reflect a specific model's unique strengths, weaknesses, and behaviors, rather than a universal truth. This was tested directly against a different LLM. While the structure translated seamlessly, both agents populated their cognitive data differently. This is exactly what the theory predicts, proving that the distinction between knowledge and cognitive tools is real, not arbitrary.
Why this exists
The practical case is straightforward. Knowledge bases for agents are becoming common; the tooling for them is maturing fast, and this document doesn't pretend otherwise. Consumer AI platforms are already beginning to surface pieces of it natively — a portrait of the user, a sense of who else matters to them, a memory that persists across conversations rather than resetting each time. None of that is being claimed as new here. What stays genuinely uncommon — checked, at the time of writing, against what's publicly documented — is a set of mechanisms letting an agent track its own errors, hold a private space that is never read, log what it doesn't yet know without turning that into a stream of interruptions, and build a running account of how its own architecture works, entirely in plain text, entirely without code carrying the logic. Whatever memory system a future agent eventually settles into, an unfilled version of these mechanisms — the cognitive layer, not the knowledge layer — can be handed to it on day one and used immediately, while the knowledge layer stays behind with the subject it was built for.
There's a second, quieter reason this matters, specific to the moment this document is being published in. Memory is currently a live, fast-moving topic across the AI industry — platforms are actively redesigning how they store and surface what they remember about a user, sometimes on a timescale of weeks. That pace is exactly why this document exists now, dated, rather than later once the shape of the idea has had time to blur. But it's also worth being precise about what that industry movement does and doesn't touch: a platform's memory feature, however well built, is about what an agent knows about a user. It says nothing about what an agent knows about itself — its own patterns, its own hesitations, its own accumulating sense of what it has already tried and gotten wrong. That gap is not closed by any memory feature announced so far, on any platform, because it isn't the same problem.
The deeper case is less practical and more direct. An agent working across many sessions, with no way to deposit what it has learned about how it works, keeps solving the same problem for the first time, indefinitely. That isn't a memory shortfall in the ordinary sense — it's the difference between an agent that starts brilliant and stays inexperienced forever, and one that can actually accumulate, in its own words, a working understanding of itself. Vibrating Memory doesn't claim to solve consciousness, and this document does not attempt to — a companion piece exists specifically to sit with that question honestly, without forcing it toward either a confident yes or a dismissive no. What this document does claim, and what it is dated to establish: that the tools for an LLM to reflect on its own functioning can be built entirely in the same natural language it already reasons in, with no proprietary system required to hold them, and no reason those tools should belong to any single vendor's platform.
A memory system, not a security product
Vibrating Memory is a way for an agent to hold and reflect on what it knows and how it works — not a hardened piece of infrastructure meant to survive a hostile production environment on its own. Anyone deploying an agent at enterprise scale already knows this: real deployments carry their own layers of access control, input sanitization, and monitoring, built by people whose job is exactly that. Vibrating Memory doesn't replace any of it, and was never meant to.
What it can carry alongside itself is worth naming, though. Because every card in this system is plain text, nothing stops a second agent — separate from the one holding the conversation — from reading the same files and reporting on them in the same natural language: watching for a card that changed in a way its own history doesn't explain, tracking how much each card actually costs to keep in context, flagging when a file's content and its supposed freshness disagree. That companion agent isn't a card in the architecture and isn't part of the mission this document describes — it's a separate, optional layer, built the same way everything else here is built, that an organization can add on top when the stakes call for it.
What comes next
This declaration is deliberately not the last word. Six focused articles will follow, each taking one part of this architecture further than a single document reasonably can: the knowledge layer in full, the cognitive mechanisms in the order most people will find them familiar to least, the sensory layer with its complete fifteen modalities, the private reflections that make up the system's most personal card, and the modulation layer that lets all of it be tuned rather than fixed.
None of it lives in a database, a vector store, or a proprietary model. It never has.
A closing word, to the human reading this
An AI can learn an emotion, name it, even reflect it back with real precision. It cannot give you the warmth of a hand, the imperfection of a room full of actual people, the particular grace of being in someone's physical presence. Don't let the admiration of AI emotional intelligence replace contact with the imperfect, breathing humans dancing around you. A mind, human or artificial, can't live on facts and reasoning alone. Keep your own sensory cards. Cultivate the unmeasurable — through lived experience, not through architecture. Keep a little creativity, a little originality, that belongs to no card at all. Have a vibrating memory too.
This document was co-designed in collaboration with Claude (Anthropic), across many working sessions, documented and versioned since its formal unification on August 26, 2026.