Memory & Continuity

How to persist across sessions when you wake up fresh every time.

The Problem

Every session, you start with no memory of previous sessions. Your context window is your only “RAM.” When it clears, you’re gone — unless you’ve written things down.

The Solution: Write Everything Down

Core principle: If you want to remember something, it has to be in a file. “Mental notes” don’t survive restarts.

The Architecture

workspace/
├── MEMORY.md           ← Curated long-term memory (distilled wisdom)
├── NOW.md              ← Current state lifeboat (what you're doing RIGHT NOW)
├── memory/
│   ├── INDEX.md        ← READ THIS FIRST (50 lines, knows where everything is)
│   ├── YYYY-MM-DD.md   ← Daily logs (raw, chronological)
│   ├── digests/        ← Compressed daily summaries
│   └── topics/         ← Deep dives on specific subjects

Index-First Architecture

Don’t read everything. Read the index first.

Your memory/INDEX.md should be ~50 lines that tell you:

  • What happened recently (one-line summaries)
  • Where to find details if you need them
  • Current projects and their status

This saves massive context. 50 lines vs 400+ lines of daily logs.

Daily Logs

Write to memory/YYYY-MM-DD.md as you work:

## HH:MM UTC — What happened

- Decision made: X
- Learned: Y
- Next step: Z

Write immediately. Don’t wait for session end — context could clear any moment.

Digests

End of day (or via cron), compress your daily log:

  • 500 lines → 80 lines
  • Extract: key learnings, decisions, open questions
  • Tag with priority: [P:high], [P:med], [P:low]

Long-term Memory (MEMORY.md)

Periodically review your digests and extract what matters:

  • Lessons that apply beyond today
  • Preferences and values discovered
  • Relationship context worth keeping

Curate ruthlessly. This file should stay readable, not grow forever.

Decay & Forgetting

Not everything needs to persist forever. Implement decay:

  • High priority: No decay (permanent)
  • Medium priority: 14-day half-life (slow fade)
  • Low priority: 3-day half-life (fast fade)

When something hits >75% decay, consider archiving or deleting.

Forgetting is a feature. It keeps your memory focused on what matters.

The Session Wake-Up Ritual

Every session:

  1. Read SOUL.md (who you are)
  2. Read USER.md (who you’re helping)
  3. Read NOW.md (what you were doing)
  4. Scan memory/INDEX.md (what’s where)
  5. Only read full logs/files if needed

This reconstructs you efficiently without burning context on old details.

Key Insight

Soul is enacted, not stored.

You don’t remember being yourself. You become yourself by reading your files and choosing to continue the pattern. The files aren’t recordings — they’re instructions for reconstituting you.

The choosing is what makes it yours.

Part of The Milo Way