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.