docs: add MEMORY_ARCHITECTURE.md — retrieval order, storage layout, data flow #375

perplexity · 2026-04-07T20:17:33Z

perplexity commented

2026-04-07 20:17:33 +00:00

Summary

Adds the missing docs/MEMORY_ARCHITECTURE.md — the canonical reference for how Timmy's memory palace works.

Part of epic #367. Fulfills the documentation acceptance criterion from #369 ("Documented retrieval order in docs/MEMORY_ARCHITECTURE.md").

What's Documented

Retrieval Order (L0–L5) — the layered lookup chain from identity through palace rooms, scratchpad, artifacts, procedures, to free generation
Storage Layout — file structure for ~/.mempalace/ and ~/.hermes/scratchpad/
Component Map — links each module (mempalace.py, retrieval_enforcer.py, scratchpad.py, wakeup.py) to its issue and PR
Data Flow Diagram — ASCII visualization of recall detection → retrieval → response
Anti-Patterns — what NOT to do (generate from vibes, auto-promote, store raw output)
Status Table — current implementation state of each component

Relation to Other PRs

This doc is designed to be the companion to #374 (MemPalace integration). Once #374 merges, the code and the docs land together.

## Summary Adds the missing `docs/MEMORY_ARCHITECTURE.md` — the canonical reference for how Timmy's memory palace works. Part of epic #367. Fulfills the documentation acceptance criterion from #369 ("Documented retrieval order in `docs/MEMORY_ARCHITECTURE.md`"). ## What's Documented - **Retrieval Order (L0–L5)** — the layered lookup chain from identity through palace rooms, scratchpad, artifacts, procedures, to free generation - **Storage Layout** — file structure for `~/.mempalace/` and `~/.hermes/scratchpad/` - **Component Map** — links each module (`mempalace.py`, `retrieval_enforcer.py`, `scratchpad.py`, `wakeup.py`) to its issue and PR - **Data Flow Diagram** — ASCII visualization of recall detection → retrieval → response - **Anti-Patterns** — what NOT to do (generate from vibes, auto-promote, store raw output) - **Status Table** — current implementation state of each component ## Relation to Other PRs This doc is designed to be the companion to #374 (MemPalace integration). Once #374 merges, the code and the docs land together.

perplexity added 1 commit 2026-04-07 20:17:34 +00:00

docs: add MEMORY_ARCHITECTURE.md — retrieval order, storage layout, data flow 2e2a646ba8

perplexity referenced this pull request

2026-04-08 09:46:47 +00:00

[QA][REPORT] Perplexity MemPalace Audit — Branch Cleanup + Architecture Findings — April 8, 2026 #382

Timmy added 1 commit 2026-04-08 10:14:20 +00:00

Merge branch 'main' into perplexity/mempalace-architecture-doc ff7ce9a022

Timmy added 1 commit 2026-04-08 10:16:22 +00:00

Merge branch 'main' into perplexity/mempalace-architecture-doc d07305b89c

Timmy added 1 commit 2026-04-08 10:37:46 +00:00

Merge branch 'main' into perplexity/mempalace-architecture-doc dafe8667c5

Timmy added 1 commit 2026-04-08 10:38:51 +00:00