docs: update workflow constraints, rules, and project documentation

README.md

@@ -86,6 +86,18 @@ Update your WSL ~/.gemini/config/mcp_config.json:
 }
 `
 *Note: The --wake-cmd ensures that if you start WSL while Windows is completely asleep, the Linux stub will use WSL interop to silently spin up the Windows daemon in the background before connecting.*
+
+## Native Local Ollama LLM Handshake
+`mcp-memory-server` directly interfaces with local Ollama instances (e.g. `http://192.168.1.30:11434`) via a native compiled Rust client (`server/src/ollama.rs`):
+* **Connection Handshake:** On startup and before executing LLM-enhanced tools, `mcp-memory-server` issues a **1.5-second health probe** (`GET /api/tags`).
+* **Environment Configuration (`mcp_config.json`):**
+  * `OLLAMA_URL`: Target Ollama host URL (default: `http://192.168.1.30:11434`).
+  * `OLLAMA_CODER_MODEL`: Local coding model (e.g., `qwen2.5-coder:1.5b`).
+  * `OLLAMA_REASONING_MODEL`: Chain-of-thought reasoning model (e.g., `deepseek-r1:1.5b`).
+  * `OLLAMA_VISION_MODEL`: Multimodal vision model (e.g., `qwen3-vl:2b`).
+  * `OLLAMA_EMBED_MODEL`: Dense embedding model (e.g., `nomic-embed-text:latest`).
+* **Graceful Degradation Guarantee:** If the local Ollama host is offline or unreachable, **no tool ever fails.** Every tool automatically falls back to pure Rust execution and local `redb`/`Tantivy` storage.
+
 `
 ## Push Safety Gates
 The daemon also operates as a global safety gate for Git. Before pushing code, run: