diff --git a/docs/MEMORY.md b/docs/MEMORY.md
new file mode 100644
index 0000000..b462ea5
--- /dev/null
+++ b/docs/MEMORY.md
@@ -0,0 +1,5 @@
+# Memory Plan (sqlite + FAISS)
+- sqlite: embeddings.db with tables: chunks(id, file, sha, lineno, text, ts), vectors(id, dim, data BLOB)
+- faiss: faiss.index for fast ANN; sqlite is source of truth
+- provenance mandatory; ripgrep is canonical text source
+- journal is never overwritten; only append