diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md
index 75767ce..ca1f63a 100644
--- a/.claude/CLAUDE.md
+++ b/.claude/CLAUDE.md
@@ -27,6 +27,8 @@ Telnet MUD engine built on telnetlib3. Python 3.12+, managed with uv.
 
 ## Docs
 
+Consult `docs/index.rst` when starting unfamiliar work to find relevant docs.
+
 Three categories in `docs/`. Plain text or rst, not markdown.
 
 - `docs/how/` - how things work. write one when you build something non-obvious.
diff --git a/docs/plans/roadmap.rst b/docs/plans/roadmap.rst
index 071a2be..5556e78 100644
--- a/docs/plans/roadmap.rst
+++ b/docs/plans/roadmap.rst
@@ -133,7 +133,8 @@ portals:
 depends on: phase 3 (portals and containers are Things)
 enables: multi-zone world, interior spaces, locked doors, bags, keys
 refs: object-model.rst (Container, Portal sections),
-      zones-and-building.rst (zone data format, hand-built zones)
+      zones-and-building.rst (zone data format, hand-built zones),
+      persistence.txt (what's persisted vs runtime — container contents not yet)
 
 
 phase 5: verbs + interaction