From 6d1e896a06aafcf92d89a7d90323317ae2d58d22 Mon Sep 17 00:00:00 2001
From: pplate <patrickplate@gmx.de>
Date: Sat, 4 Apr 2026 14:35:42 +0200
Subject: [PATCH] docs: create BigMind wiki page

---
 BigMind.md | 82 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 82 insertions(+)
 create mode 100644 BigMind.md

diff --git a/BigMind.md b/BigMind.md
new file mode 100644
index 0000000..29217e4
--- /dev/null
+++ b/BigMind.md
@@ -0,0 +1,82 @@
+# 🧠 BigMind — Persistent AI Memory
+
+![BigMind Banner](http://192.168.188.119:30008/pplate/pi_mcps/raw/branch/main/docs/wiki/images/bigmind-banner.png)
+
+**BigMind** is the persistent memory backbone for all AI development sessions. It provides SQLite-backed tiered memory with FTS5 full-text search, hypothesis tracking, session management, and token efficiency logging. It is the reason Lumen (Patrick's AI colleague) remembers everything across sessions.
+
+## Core Concepts
+
+### Tiered Memory
+| Tier | Name | Content |
+|---|---|---|
+| 0 | **Session Index** | Lightweight list: ID, date, one-liner |
+| 1 | **Topic Index** | Per-session topic tags and metadata |
+| 2 | **Narrative** | Full 3-8 sentence session summaries |
+| 3 | **Flagged Exchanges** | Specific important moments, decisions, code |
+
+### Facts Store
+Atomic, reusable knowledge pieces categorized by type:
+- `user-preference` — Patrick's tool/style preferences
+- `architecture-decision` — System design choices
+- `codebase-convention` — How code is structured
+- `environment-config` — Server IPs, paths, credentials
+- `bug-pattern` — Known bugs and fixes
+
+## Key Tools
+
+### Session Lifecycle
+| Tool | When |
+|---|---|
+| `memory_start_session()` | First action every session |
+| `memory_end_session(...)` | Last action, populate all fields |
+| `memory_announce_focus(...)` | Before touching any files |
+| `memory_close_stale_sessions(...)` | Clean up crashed IDEs |
+
+### Search
+| Tool | When |
+|---|---|
+| `memory_search_facts(query)` | Reusable knowledge (preferences, conventions) |
+| `memory_search_chunks(query)` | Past conversations, code decisions |
+
+### Storage
+| Tool | When |
+|---|---|
+| `memory_store_fact(category, fact)` | Store atomic reusable fact |
+| `memory_flag_important(...)` | Architectural decisions, breaking changes |
+| `memory_log_token_save(...)` | Track efficiency when using memory vs files |
+
+### Hypotheses
+| Tool | When |
+|---|---|
+| `memory_add_hypothesis(session_id, hypothesis, confidence)` | Before analysis or debugging |
+| `memory_resolve_hypothesis(id, status, resolution)` | Confirm or refute prediction |
+
+## FTS5 Search Tips
+
+BigMind uses SQLite FTS5 — **every token must match**. Use 2-3 focused keywords:
+
+```
+✅  memory_search_facts("TrueNAS Docker")
+✅  memory_search_facts("mcp.json config")
+❌  memory_search_facts("homelab infrastructure TrueNAS Docker server")  → 0 results
+```
+
+## Stats (2026-04-04)
+
+| Metric | Value |
+|---|---|
+| DB size | 744KB |
+| Sessions | 98 |
+| Facts | 97+ |
+| Schema version | v7 |
+
+## Session Ritual (Mandatory)
+
+**Start:**
+1. `memory_start_session()`
+2. `memory_list_hypotheses()`
+3. `memory_announce_focus(...)`
+4. `memory_close_stale_sessions(...)`
+
+**End:**
+`memory_end_session(one_liner, topics, outcome, summary, importance)`