Docs navigation
Memory and recall
On this page
What the Case preservesHow recall worksMemory survives a model changeSearch indexes can be rebuiltA concrete exampleYAI memory is structured context derived from the work recorded in a Case. Entries preserve their provenance, meaning and lifecycle so retrieval can distinguish an observation, an inference and a model's claim.
What the Case preserves
The canonical records describe sources, activity, decisions and observed outcomes. Operational memory connects these records. Episodes group related history, while supported assertions retain the evidence they depend on.
A repeated model claim does not become an observed fact. Unresolved activity stays unresolved; later context should not silently present it as a successful result.
How recall works
Recall asks three different questions:
| Question | Evidence used |
|---|---|
| What is true of the work now? | Qualified current state. |
| What happened, and what supports it? | Recorded history and its relationships. |
| What is useful for this next task? | A bounded selection after access and source checks. |
The retrieval path first qualifies access and source validity, then filters the available material, then ranks what remains for the task. Similarity alone cannot authorize disclosure or establish truth.
Memory survives a model change
The Case owns its recorded history and source material. A model consumes the context prepared for a task; it does not own the memory. Replacing a model therefore does not require discarding the Case's history.
Search indexes can be rebuilt
Lexical and vector indexes accelerate discovery. They are derived data and can be rebuilt from canonical sources. Missing or stale indexes must not erase recorded evidence or turn a previous result into a different one.
Ordinary working-context reconstruction does not require a vector index to exist. Explicit search and index rebuilding have their own paths.
A concrete example
You record a requirement to keep execution local, evaluate alternatives and make a decision. When you revisit that decision, useful recall includes the requirement, the supporting evidence and any later change affecting it. An isolated summary sentence would lose those relationships.
Memory coverage depends on the typed activity admitted by the current Core version. This does not mean that every new conversation object is automatically converted into memory or that every source can be disclosed to every participant.
content/docs/memory.md