x:0 y:0 Memory / 01
Persek OS · Subsystem

Memory

Separate knowledge surfaces. Clear boundaries. Regular review.

Most software treats memory as a single bucket. Persek OS doesn't. Different kinds of knowledge live in different stores, each with its own rules for who writes, who reads, and how often things expire.

The reason is hygiene. Keeping knowledge accurate over years means not letting one kind of claim silently overwrite another. The system has six stores, one rule that says where each claim belongs, and regular review that keeps things from rotting in place.

← Back to Persek OSNext subsystem · Intelligence →

x:860 y:0 Stores / 02
Six stores · Six jobs

Each one a different kind of claim.

Knowledge in Persek OS lives in six places. Each store is good at one job and bad at the others. Mixing them up is how systems quietly rot.

MEMORY / SIX STORES REFERENCE ACTIVE LIVE CANON operating guidance · standards · rules Hand-edited only. Never written at runtime. R/O LLM WIKI compiled research library Append-only. Sources compile up into articles. GBRAIN live entity graph Shared write with source checks. Truth + timeline. AGENT MEMORY per-agent topical Read-write by the owner. Refresh-on-read for prefs. AUTO-MEMORY learned preferences Captured mid-session. Curated at session end. SESSION DOC live context Gone when the session ends.

Canon behavior · hand-edited

Agent rules and standards. The instructions every agent loads on startup. Edited by hand, never written at runtime. This is the layer that says how each agent thinks.

gBrain entities · shared write

Live entities. People, projects, companies, concepts. Each entity has compiled truth (the synthesized current view) and a timeline (append-only evidence). Multiple agents can write here with source checks and review boundaries. Built by Garry Tan and integrated into the harness.

LLM Wiki research · append-only

External research. Compiled bibliographies, source ingestion, topic-level synthesis. The library Persek OS reads from when it needs to know what the world says about something. Built by nvk and integrated into the harness.

Agent memory topical · per-agent

Per-agent topical knowledge. Each agent has its own memory directory for things it has learned about its domain. Owned by the agent, refreshed on read.

Auto-memory learned · cross-session

Preferences and facts learned during sessions. The user says "don't do X" once; auto-memory remembers. Curated at session end, survives across sessions.

Session doc live · ephemeral

Current session context. Decisions made, work in flight, blockers. Gone when the session ends, but written to a continuity file so the next session picks up cleanly.

Six stores · one boundary rule
x:0 y:720 Boundary Rule / 03
One rule, six stores

Every claim has exactly one home.

The rule that keeps the six stores from rotting into each other.

Without a boundary rule, the same claim ends up in three places. Two of them go stale. The agent reading the stale one acts on bad information. Multiply by years and the system collapses under its own weight.

The rule is simple: each kind of knowledge has one proper home. That keeps stale context from spreading and makes review possible when facts change.

The routing decision is enforced by discipline and source checks. When in doubt, the destination that can legitimately hold the claim is the right one.

x:0 y:1440 Write Pipeline / 04
How durable memory changes safely

The durable memory path.

Six steps from "I want to remember this" to "it is safely in durable memory." The fourth step is the trust layer. Other surfaces are lighter, but durable claims get the most review.

MEMORY PATH / 6 STEPS 01 DECIDE agent 02 READ check first 03 REVIEW clear path 04 · CHECK SOURCE REVIEW weak source waits 05 WRITE store applies 06 TRACE reviewable If the source is weak, the claim waits for review.
01
DecideAn agent has something worth remembering. Could be a session observation, a tool result, something the user said in passing.
02
Read firstBefore writing, check what the target store already knows. Avoid overwriting context you have not seen.
03
Reviewable pathDurable writes go through a reviewable path rather than an ad hoc note.
04
Source checkEvery durable claim needs a real source. If the source is missing or weak, the write waits for review.
05
Upstream writeThe store receives the claim and applies it. Compiled truth gets revised; the timeline gets appended.
06
TraceEvery successful durable change leaves enough context to review later. When a claim turns out wrong, the source can be found.
x:940 y:1440 Memory Review / 05
What keeps memory honest

Review on a schedule.

Regular review passes keep memory from drifting.

A live system accumulates drift. Stale entries pile up. Two agents can write contradicting facts. Sources move. Without maintenance, the memory rots from the inside. The system surfaces findings to me, not to itself, because nothing gets auto-resolved.

Review pass recurring

Checks for stale entries, broken sources, and anything that needs review. Advisory only. Nothing gets auto-deleted. Items wait for human review.

Consistency check recurring

Looks for contradictions across agents and flags them for me to review and resolve. The system surfaces; I arbitrate. Nothing gets rewritten autonomously.

Health report periodic

Reports on memory health: review volume, source quality, size trends, and entries flagged for attention.

Review briefing regular

The human-readable output becomes one review queue: what got flagged, what is stale, and what needs attention.

Output: a morning dashboard
next dragpan 0fit all Eschome
Want to reach out? X is best.
x / @dpersek linkedin github / syntaxsawdust