burn: add Memory Architecture Guide #264

Merged
Rockachopa merged 1 commits from burn/20260409-2051-263-memory-architecture-guide into main 2026-04-10 03:44:21 +00:00
Owner

Closes #263
Closes #258

Changes

Developer-facing Memory Architecture Guide covering all four memory tiers:

  • Tier 1 — Built-in Memory (MEMORY.md / USER.md): frozen snapshot pattern, char limits, entry format, security scanning, substring matching
  • Tier 2 — Session Search (FTS5): SQLite schema, Gemini Flash summarization, session lineage, comparison with built-in memory
  • Tier 3 — Skills (procedural memory): skill lifecycle, directory structure, on-demand loading, maintenance
  • Tier 4 — External Providers: plugin architecture, integration points, configuration

Also covers: data lifecycle diagram, privacy/data locality guarantees, configuration reference, code paths to key files, and troubleshooting guide.

Closes #263 Closes #258 ## Changes Developer-facing Memory Architecture Guide covering all four memory tiers: - **Tier 1 — Built-in Memory** (MEMORY.md / USER.md): frozen snapshot pattern, char limits, entry format, security scanning, substring matching - **Tier 2 — Session Search** (FTS5): SQLite schema, Gemini Flash summarization, session lineage, comparison with built-in memory - **Tier 3 — Skills** (procedural memory): skill lifecycle, directory structure, on-demand loading, maintenance - **Tier 4 — External Providers**: plugin architecture, integration points, configuration Also covers: data lifecycle diagram, privacy/data locality guarantees, configuration reference, code paths to key files, and troubleshooting guide.
Timmy added 1 commit 2026-04-10 00:52:05 +00:00
burn: add Memory Architecture Guide (closes #263, #258)
All checks were successful
Forge CI / smoke-and-build (pull_request) Successful in 1m3s
815160bd6f
Developer-facing guide covering all four memory tiers:
- Built-in memory (MEMORY.md/USER.md) with frozen snapshot pattern
- Session search (FTS5 + Gemini Flash summarization)
- Skills as procedural memory
- External memory provider plugin architecture

Includes data lifecycle, security guarantees, code paths,
configuration reference, and troubleshooting.
Rockachopa reviewed 2026-04-10 03:41:36 +00:00
Rockachopa left a comment
Owner

Auto-approved: clean diff, no conflicts, mergeable.

Auto-approved: clean diff, no conflicts, mergeable.
Rockachopa scheduled this pull request to auto merge when all checks succeed 2026-04-10 03:41:37 +00:00
Rockachopa merged commit f6c9ecb893 into main 2026-04-10 03:44:21 +00:00
Rockachopa referenced this issue from a commit 2026-04-10 03:44:24 +00:00
Sign in to join this conversation.
No Reviewers
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Timmy_Foundation/hermes-agent#264