diff --git a/docs/fleet-memory.md b/docs/fleet-memory.md
index 0a9df2b..ab70d23 100644
--- a/docs/fleet-memory.md
+++ b/docs/fleet-memory.md
@@ -13,14 +13,14 @@ This document covers: what the stores are, what a central palace changes when se
 
 ```mermaid
 flowchart LR
-    Q["ask by MEANING<br/>'what do we know about X?'"] --> D["<b>Drawers</b><br/>chroma.sqlite3<br/>verbatim text, embedded"]
-    R["ask by ENTITY + TIME<br/>'what was true in June?'"] --> G["<b>Knowledge graph</b><br/>knowledge_graph.sqlite3<br/>typed facts, time-bounded"]
-    S["ask by ADDRESS + ORDER<br/>'what is waiting for me?'"] --> L["<b>Coordination log</b><br/>logstream.sqlite3<br/>addressed events + artifacts"]
-    T["ask by ASSOCIATION<br/>'what else touches this?'"] --> P["<b>Palace graph</b><br/>tunnels.json + hallways.json<br/>links between rooms"]
-    D --> DI["<b>Diaries</b> live here too:<br/>drawers with room=diary,<br/>read by recency, not similarity"]
+    Q["ask by MEANING<br/>'what do we know about X?'"] --> D["<b>Drawers</b><br/>chroma.sqlite3"]
+    R["ask by ENTITY + TIME<br/>'what was true in June?'"] --> G["<b>Knowledge graph</b><br/>knowledge_graph.sqlite3"]
+    S["ask by ADDRESS<br/>'what is waiting for me?'"] --> L["<b>Coordination log</b><br/>logstream.sqlite3"]
+    T["ask by ASSOCIATION<br/>'what else touches this?'"] --> P["<b>Palace graph</b><br/>tunnels.json + hallways.json"]
+    D --> DI["<b>Diaries</b> live here too:<br/>drawers with room=diary"]
 ```
 
-All four stores are files inside **one palace directory**, so "the palace" is a directory you can back up in one go.
+All four stores are files inside **one palace directory**, so "the palace" is a directory you can back up in one go. Each holds a different *shape* of thing: drawers hold verbatim text, embedded for similarity; the knowledge graph holds typed facts that are time-bounded; the coordination log holds addressed events and their artifacts, read in append order; the palace graph holds links between rooms. Diaries are drawers, but they are read by recency rather than by similarity.
 
 | Store | You get things back by | Typical use | Wrong use |
 |---|---|---|---|
@@ -110,19 +110,19 @@ sequenceDiagram
 
 ## 3. Deciding where something goes
 
-The question that matters is not "is this important?" but **"how will I want this back, and does anyone need to act?"**
+The question that matters is not "is this important?" but **"how will I want this back, and does a specific machine or agent need to act?"**
 
 ```mermaid
 flowchart TD
-    Start["I have something worth keeping"] --> Act{"Must a specific<br/>machine or agent<br/>DO something?"}
+    Start["I have something worth keeping"] --> Act{"Must someone specific<br/>DO something?"}
     Act -->|no| Change{"Is it a fact that<br/>changes over time?"}
     Act -->|yes| Know{"Do they also need<br/>to KNOW it later?"}
     Change -->|yes| KG["Knowledge graph<br/>kg_add / kg_supersede"]
-    Change -->|no| Mine{"Is it about MY session<br/>— what I tried, felt, learned?"}
+    Change -->|no| Mine{"Is it about MY session<br/>— tried, felt, learned?"}
     Mine -->|yes| Diary["Diary entry"]
     Mine -->|no| Drawer["Drawer<br/>wing + room, verbatim"]
-    Know -->|yes| Both["BOTH:<br/>drawer for the knowledge,<br/>event pointing at it"]
-    Know -->|no| Event["Coordination event<br/>to_agent = the specific agent"]
+    Know -->|yes| Both["BOTH:<br/>drawer + event pointing at it"]
+    Know -->|no| Event["Coordination event<br/>to_agent = that agent"]
 ```
 
 Worked examples: