docs: improve accuracy and add debugging guide

README.md:
- Add architecture infographic
- Fix command syntax to use colon format (/memory:capture)
- Add hook configuration environment variables

USER_GUIDE.md:
- Add comprehensive "Debugging, Discovery & Memory Review" section
- Add memory discovery, searching strategies, quality review
- Add debugging commands and maintenance tasks
- Update Table of Contents
- Fix command syntax throughout

DEVELOPER_GUIDE.md:
- Fix incorrect timeout values to match config.py
- Add hooks module to package structure

skills/memory-recall/:
- Fix incomplete namespace table (all 10 namespaces)
- Rewrite namespace-guide.md with complete documentation
- Fix search result attribute names in examples

Author: zircote

README.md

@@ -2,6 +2,10 @@
 
 Git-native, semantically-searchable memory storage for Claude Code.
 
+<p align="center">
+  <img src="docs/_assets/infograph-git-notes-memory-project-memory.png" alt="Git Notes Memory Architecture" width="800"/>
+</p>
+
 <!-- Badges -->
 [![CI](https://github.com/zircote/git-notes-memory-manager/actions/workflows/ci.yml/badge.svg)](https://github.com/zircote/git-notes-memory-manager/actions/workflows/ci.yml)
 [![PyPI version](https://img.shields.io/pypi/v/git-notes-memory.svg)](https://pypi.org/project/git-notes-memory/)
@@ -21,7 +25,7 @@ Git-native, semantically-searchable memory storage for Claude Code.
 - **Git-native storage**: Memories stored as git notes that sync with push/pull
 - **Semantic search**: Find relevant memories via sentence-transformer embeddings
 - **10 memory namespaces**: inception, elicitation, research, decisions, progress, blockers, reviews, learnings, retrospective, patterns
-- **Progressive hydration**: Load memory content incrementally (SUMMARY → FULL → FILES)
+- **Progressive hydration**: Load memory content incrementally (SUMMARY -> FULL -> FILES)
 - **Concurrent-safe**: File locking prevents corruption from parallel captures
 - **XDG-compliant**: Standard paths on all platforms
 
@@ -55,15 +59,15 @@ memories = recall.search("database choice", namespace="decisions", limit=5)
 
 ## Claude Code Plugin
 
-When used as a Claude Code plugin, the following commands are available:
+When used as a Claude Code plugin, the following slash commands are available:
 
-- `/remember <namespace> <summary>` - Capture a memory
-- `/recall <query>` - Search memories semantically
-- `/context <spec>` - Load all memories for a spec
-- `/memory status` - Show index statistics
-- `/memory reindex` - Rebuild the search index
-- `/memory verify` - Check index consistency
-- `/memory gc` - Garbage collect old memories
+| Command | Description |
+|---------|-------------|
+| `/memory:capture <namespace> <summary>` | Capture a memory |
+| `/memory:recall <query>` | Search memories semantically |
+| `/memory:search <query>` | Advanced search with filters |
+| `/memory:sync [full\|verify\|repair]` | Synchronize or repair the index |
+| `/memory:status [--verbose]` | Show index statistics |
 
 ### Hooks Integration
 
@@ -94,13 +98,19 @@ make quality
 
 ## Configuration
 
-Environment variables:
+Environment variables (see `.env.example` for all options):
 
 | Variable | Description | Default |
 |----------|-------------|---------|
 | `MEMORY_PLUGIN_DATA_DIR` | Data directory path | `~/.local/share/memory-plugin/` |
 | `MEMORY_PLUGIN_GIT_NAMESPACE` | Git notes namespace | `refs/notes/mem` |
 | `MEMORY_PLUGIN_EMBEDDING_MODEL` | Embedding model name | `all-MiniLM-L6-v2` |
+| `MEMORY_PLUGIN_AUTO_CAPTURE` | Enable auto-capture hook | `false` |
+
+### Hook Configuration
+
+| Variable | Description | Default |
+|----------|-------------|---------|
 | `HOOK_ENABLED` | Master switch for hooks | `true` |
 | `HOOK_SESSION_START_ENABLED` | Enable SessionStart context injection | `true` |
 | `HOOK_USER_PROMPT_ENABLED` | Enable signal detection in prompts | `false` |

docs/DEVELOPER_GUIDE.md

@@ -36,7 +36,18 @@ git_notes_memory/
 ├── utils.py            # Utility functions
 ├── search.py           # SearchOptimizer
 ├── patterns.py         # PatternManager
-└── lifecycle.py        # LifecycleManager
+├── lifecycle.py        # LifecycleManager
+└── hooks/              # Hook handler modules
+    ├── session_start_handler.py
+    ├── user_prompt_handler.py
+    ├── stop_handler.py
+    └── services/       # Hook support services
+        ├── context_builder.py
+        ├── project_detector.py
+        ├── signal_detector.py
+        ├── novelty_checker.py
+        ├── capture_decider.py
+        └── session_analyzer.py
 ```
 
 ---
@@ -598,13 +609,13 @@ from git_notes_memory.config import (
     MAX_SUMMARY_CHARS,             # 100
     MAX_RECALL_LIMIT,              # 100
 
-    # Timeouts
-    SEARCH_TIMEOUT_MS,             # 5000
-    CAPTURE_TIMEOUT_MS,            # 30000
-    LOCK_TIMEOUT_SECONDS,          # 30
+    # Timeouts (in milliseconds unless noted)
+    SEARCH_TIMEOUT_MS,             # 500
+    CAPTURE_TIMEOUT_MS,            # 2000
+    LOCK_TIMEOUT_SECONDS,          # 5
 
     # Lifecycle
-    DECAY_HALF_LIFE_DAYS,          # 30.0
+    DECAY_HALF_LIFE_DAYS,          # 30
 )
 ```