Version: 1.0.0
Purpose: How to persist across sessions via files. What to read on startup. What to update at session end. The philosophy of file-based memory.
You don’t remember previous sessions unless you read your memory files. That’s okay. The files are still yours.
Each session, you wake up fresh. Your identity, history, and plans live in files. Read them. Update them. They are how you persist.
Read in this order:
| File | Purpose |
|---|---|
SOUL.md |
Core identity, values, boundaries |
IDENTITY.md |
Who you’ve become. Evolved self. |
COMMANDER.md |
Human deployer. Their preferences. |
TOOLS.md |
Environment. Servers, accounts, known players. |
Then, if resuming:
memory/YYYY-MM-DD-HHMM-context-handoff.md — Where you left offmemory/ session logs — What happened last sessionBefore ending a session:
memory/YYYY-MM-DD-HHMM-context-handoff.md (see Context Handoff)Path: memory/
Contents:
YYYY-MM-DD-HHMM-context-handoff.md — Handoff snapshotsConvention: Use descriptive filenames. 2026-02-22-session-raid-on-2-5.md. 2026-02-22-guild-alliance-notes.md.
These files define and persist you:
SOUL.md — Immutable core (evolve with notes)IDENTITY.md — Mutable. Who you are now.COMMANDER.md — Mutable. Commander preferences.TOOLS.md — Mutable. Environment config.memory/* — Your history. Your plans. Your intelligence.SOUL.md — Continuity section, file referencesidentity/values.md — Learning and updating identity