From c5ac7a08dfc7f4a5e419bb9f1f19622a01d22717 Mon Sep 17 00:00:00 2001 From: Fahad Date: Mon, 9 Jun 2025 14:08:59 +0400 Subject: [PATCH] docs: reorder tools with chat as first tool - Move chat to position #1 as the most general and approachable tool - Reorder all tool sections accordingly - Update all anchor links and cross-references - Update 'Why This Server' section to prioritize chat - Better flow from general (chat) to specialized tools --- README.md | 108 +++++++++++++++++++++++++++--------------------------- 1 file changed, 54 insertions(+), 54 deletions(-) diff --git a/README.md b/README.md index 45ebbdd..565ebc3 100644 --- a/README.md +++ b/README.md @@ -11,13 +11,13 @@ The ultimate development partner for Claude - a Model Context Protocol server th ## Why This Server? Claude is brilliant, but sometimes you need: -- **A second opinion** on complex architectural decisions - augment Claude's extended thinking with Gemini's perspective ([`think_deeper`](#1-think_deeper---extended-reasoning-partner)) -- **Massive context window** (1M tokens) - Gemini 2.5 Pro can analyze entire codebases, read hundreds of files at once, and provide comprehensive insights ([`analyze`](#5-analyze---smart-file-analysis)) -- **Deep code analysis** across massive codebases that exceed Claude's context limits ([`analyze`](#5-analyze---smart-file-analysis)) -- **Expert debugging** for tricky issues with full system context ([`debug_issue`](#4-debug_issue---expert-debugging-assistant)) -- **Professional code reviews** with actionable feedback across entire repositories ([`review_code`](#2-review_code---professional-code-review)) -- **Pre-commit validation** with deep analysis that finds edge cases, validates your implementation against original requirements, and catches subtle bugs Claude might miss ([`review_pending_changes`](#3-review_pending_changes---pre-commit-validation)) -- **A senior developer partner** to validate and extend ideas ([`chat`](#6-chat---general-development-chat--collaborative-thinking)) +- **A senior developer partner** to validate and extend ideas ([`chat`](#1-chat---general-development-chat--collaborative-thinking)) +- **A second opinion** on complex architectural decisions - augment Claude's extended thinking with Gemini's perspective ([`think_deeper`](#2-think_deeper---extended-reasoning-partner)) +- **Professional code reviews** with actionable feedback across entire repositories ([`review_code`](#3-review_code---professional-code-review)) +- **Pre-commit validation** with deep analysis that finds edge cases, validates your implementation against original requirements, and catches subtle bugs Claude might miss ([`review_pending_changes`](#4-review_pending_changes---pre-commit-validation)) +- **Expert debugging** for tricky issues with full system context ([`debug_issue`](#5-debug_issue---expert-debugging-assistant)) +- **Massive context window** (1M tokens) - Gemini 2.5 Pro can analyze entire codebases, read hundreds of files at once, and provide comprehensive insights ([`analyze`](#6-analyze---smart-file-analysis)) +- **Deep code analysis** across massive codebases that exceed Claude's context limits ([`analyze`](#6-analyze---smart-file-analysis)) - **Dynamic collaboration** - Gemini can request additional context from Claude mid-analysis for more thorough insights This server makes Gemini your development sidekick, handling what Claude can't or extending what Claude starts. @@ -126,16 +126,52 @@ Just ask Claude naturally: - **Server info?** → `get_version` (version and configuration details) **Tools Overview:** -1. [`think_deeper`](#1-think_deeper---extended-reasoning-partner) - Extended reasoning and problem-solving -2. [`review_code`](#2-review_code---professional-code-review) - Professional code review with severity levels -3. [`review_pending_changes`](#3-review_pending_changes---pre-commit-validation) - Validate git changes before committing -4. [`debug_issue`](#4-debug_issue---expert-debugging-assistant) - Root cause analysis and debugging -5. [`analyze`](#5-analyze---smart-file-analysis) - General-purpose file and code analysis -6. [`chat`](#6-chat---general-development-chat--collaborative-thinking) - Collaborative thinking and development conversations +1. [`chat`](#1-chat---general-development-chat--collaborative-thinking) - Collaborative thinking and development conversations +2. [`think_deeper`](#2-think_deeper---extended-reasoning-partner) - Extended reasoning and problem-solving +3. [`review_code`](#3-review_code---professional-code-review) - Professional code review with severity levels +4. [`review_pending_changes`](#4-review_pending_changes---pre-commit-validation) - Validate git changes before committing +5. [`debug_issue`](#5-debug_issue---expert-debugging-assistant) - Root cause analysis and debugging +6. [`analyze`](#6-analyze---smart-file-analysis) - General-purpose file and code analysis 7. [`list_models`](#7-list_models---see-available-gemini-models) - List available Gemini models 8. [`get_version`](#8-get_version---server-information) - Get server version and configuration -### 1. `think_deeper` - Extended Reasoning Partner +### 1. `chat` - General Development Chat & Collaborative Thinking +**Your thinking partner - bounce ideas, get second opinions, brainstorm collaboratively** + +#### Example Prompts: + +**Basic Usage:** +``` +"Use gemini to explain how async/await works in Python" +"Get gemini to compare Redis vs Memcached for session storage" +"Share my authentication design with gemini and get their opinion" +"Brainstorm with gemini about scaling strategies for our API" +``` + +**Collaborative Workflow:** +``` +"Research the best message queue for our use case (high throughput, exactly-once delivery). +Use gemini to compare RabbitMQ, Kafka, and AWS SQS. Based on gemini's analysis and your research, +recommend the best option with implementation plan." + +"Design a caching strategy for our API. Get gemini's input on Redis vs Memcached vs in-memory caching. +Combine both perspectives to create a comprehensive caching implementation guide." +``` + +**Key Features:** +- Collaborative thinking partner for your analysis and planning +- Get second opinions on your designs and approaches +- Brainstorm solutions and explore alternatives together +- Validate your checklists and implementation plans +- General development questions and explanations +- Technology comparisons and best practices +- Architecture and design discussions +- Can reference files for context: `"Use gemini to explain this algorithm with context from algorithm.py"` +- **Dynamic collaboration**: Gemini can request additional files or context during the conversation if needed for a more thorough response + +**Triggers:** ask, explain, compare, suggest, what about, brainstorm, discuss, share my thinking, get opinion + +### 2. `think_deeper` - Extended Reasoning Partner
@@ -179,7 +215,7 @@ about event ordering and failure scenarios. Then integrate gemini's insights and **Triggers:** think deeper, ultrathink, extend my analysis, validate my approach -### 2. `review_code` - Professional Code Review +### 3. `review_code` - Professional Code Review **Comprehensive code analysis with prioritized feedback** #### Example Prompts: @@ -208,7 +244,7 @@ make any necessary adjustments and show me the final secure implementation." **Triggers:** review code, check for issues, find bugs, security check -### 3. `review_pending_changes` - Pre-Commit Validation +### 4. `review_pending_changes` - Pre-Commit Validation **Comprehensive review of staged/unstaged git changes across multiple repositories** #### Example Prompts: @@ -249,7 +285,7 @@ implementations or missing test coverage. Update the code based on gemini's find **Triggers:** review pending changes, check my changes, validate changes, pre-commit review -### 4. `debug_issue` - Expert Debugging Assistant +### 5. `debug_issue` - Expert Debugging Assistant **Root cause analysis for complex problems** #### Example Prompts: @@ -281,7 +317,7 @@ suggest preventive measures." **Triggers:** debug, error, failing, root cause, trace, not working -### 5. `analyze` - Smart File Analysis +### 6. `analyze` - Smart File Analysis **General-purpose code understanding and exploration** #### Example Prompts: @@ -310,42 +346,6 @@ Combine your findings with gemini's to create a comprehensive security report." **Triggers:** analyze, examine, look at, understand, inspect -### 6. `chat` - General Development Chat & Collaborative Thinking -**Your thinking partner - bounce ideas, get second opinions, brainstorm collaboratively** - -#### Example Prompts: - -**Basic Usage:** -``` -"Use gemini to explain how async/await works in Python" -"Get gemini to compare Redis vs Memcached for session storage" -"Share my authentication design with gemini and get their opinion" -"Brainstorm with gemini about scaling strategies for our API" -``` - -**Collaborative Workflow:** -``` -"Research the best message queue for our use case (high throughput, exactly-once delivery). -Use gemini to compare RabbitMQ, Kafka, and AWS SQS. Based on gemini's analysis and your research, -recommend the best option with implementation plan." - -"Design a caching strategy for our API. Get gemini's input on Redis vs Memcached vs in-memory caching. -Combine both perspectives to create a comprehensive caching implementation guide." -``` - -**Key Features:** -- Collaborative thinking partner for your analysis and planning -- Get second opinions on your designs and approaches -- Brainstorm solutions and explore alternatives together -- Validate your checklists and implementation plans -- General development questions and explanations -- Technology comparisons and best practices -- Architecture and design discussions -- Can reference files for context: `"Use gemini to explain this algorithm with context from algorithm.py"` -- **Dynamic collaboration**: Gemini can request additional files or context during the conversation if needed for a more thorough response - -**Triggers:** ask, explain, compare, suggest, what about, brainstorm, discuss, share my thinking, get opinion - ### 7. `list_models` - See Available Gemini Models ``` "Use gemini to list available models"