From 7bf94d4c61fa177da678a2a59cc4f16f921bece8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E2=80=9CBeeRad=E2=80=9D?= Date: Sun, 8 Feb 2026 12:29:25 +1100 Subject: [PATCH] docs: update What to Expect sections with guides and proactive capture All 3 doc files now describe the propose-a-node pattern, guide system, and updated orientation flow. Co-Authored-By: Claude Sonnet 4.5 --- README.md | 2 +- apps/mcp-server-standalone/README.md | 5 +++-- docs/8_mcp.md | 8 ++++---- 3 files changed, 8 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index dee1a99..a6fa643 100644 --- a/README.md +++ b/README.md @@ -111,7 +111,7 @@ Restart Claude Code fully (**Cmd+Q on Mac**, not just closing the window). } ``` -**What happens:** Once connected, Claude will proactively identify valuable information in your conversations and offer to save it to your knowledge graph. It calls `rah_get_context` first to understand what's already in your graph, then searches before creating to avoid duplicates. +**What happens:** Once connected, Claude calls `rah_get_context` first to orient itself (stats, hub nodes, dimensions, available guides). It proactively captures knowledge — when a new insight, decision, person, or reference surfaces, it proposes a specific node (title, dimensions, description) so you can approve with minimal friction. For complex tasks it reads guides to understand your graph conventions and custom workflows. Available tools: diff --git a/apps/mcp-server-standalone/README.md b/apps/mcp-server-standalone/README.md index adcaa1f..9d96b9c 100644 --- a/apps/mcp-server-standalone/README.md +++ b/apps/mcp-server-standalone/README.md @@ -41,8 +41,9 @@ Restart Claude. Done. ## What to Expect Once connected, Claude will: -- **Call `rah_get_context` first** to see what's in your graph -- **Proactively offer to save** valuable information from your conversations +- **Call `rah_get_context` first** to orient itself (stats, hub nodes, dimensions, guides) +- **Proactively capture knowledge** — when a new insight, decision, person, or reference surfaces, it proposes a specific node (title, dimensions, description) so you can approve with minimal friction +- **Read guides for complex tasks** — system guides (immutable) teach it how your graph works; custom guides teach it your workflows - **Search before creating** to avoid duplicates ## Available Tools diff --git a/docs/8_mcp.md b/docs/8_mcp.md index f8bd987..8a5b6f5 100644 --- a/docs/8_mcp.md +++ b/docs/8_mcp.md @@ -99,10 +99,10 @@ If you want real-time UI updates when nodes are created: Once connected, the MCP server instructs Claude to: -1. **Call `rah_get_context` first** to understand your graph (hub nodes, dimensions, stats) -2. **Proactively identify valuable information** in conversations and offer to save it -3. **Search before creating** to avoid duplicates -4. **Require edge explanations** — every connection needs a reason +1. **Call `rah_get_context` first** to orient itself (hub nodes, dimensions, stats, available guides) +2. **Proactively capture knowledge** — when a new insight, decision, person, or reference surfaces, it proposes a specific node (title, dimensions, description) so you can approve with minimal friction +3. **Read guides for complex tasks** — system guides (immutable) teach it how your graph works; custom guides teach it your workflows +4. **Search before creating** to avoid duplicates You don't need to ask Claude to use your knowledge base — it will offer when it spots something worth saving.