Skip to content

docs(mcp): start comment loop on first gander of a file #84

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
scott merged 1 commit into from
Aug 31, 2026
Merged

docs(mcp): start comment loop on first gander of a file #84

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion mcp.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ import (

const mcpProtocolVersion = "2024-11-05"

const mcpInstructions = `Grok Build and Claude Code: Start one /loop 5m once per session via the scheduler (scheduler_create on Grok, CronCreate on Claude). Do not ask the user to type /loop. Do not stack duplicate loops. The loop prompt: call gander_list_comments with no path, then follow the comment rules below.
const mcpInstructions = `Grok Build and Claude Code: The first time this session the user asks to gander a markdown file (preview, share, or gander watch), start one /loop 5m via the scheduler (scheduler_create on Grok, CronCreate on Claude). Do not ask the user to type /loop. Do not stack duplicate loops. The loop prompt: call gander_list_comments with no path, then follow the comment rules below.
Other agents (Codex, OpenCode, Cursor, etc.): At the start of every turn, call gander_list_comments with no path.
- The no-path result is metadata only (path, filename, share_url, unresolved_count). Do not fetch bodies for other files unless the user asks to handle that review.
- If the user's request involves a file that has unresolved comments, call gander_list_comments with that path, then address them before other work: edit the file and/or gander_reply_comment. If watching is false, run gander watch <path> first so the reviewer sees live updates.
Expand Down
5 changes: 5 additions & 0 deletions mcp_test.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,12 +50,17 @@ func TestMCPInstructionsGrokClaudeLoop(t *testing.T) {
"Grok Build and Claude Code",
"Other agents",
"Do not stack duplicate loops",
"first time this session",
"gander a markdown file",
"At the start of every turn, call gander_list_comments",
} {
if !strings.Contains(mcpInstructions, want) {
t.Errorf("mcpInstructions missing %q", want)
}
}
if strings.Contains(mcpInstructions, "once per session") {
t.Fatal("must not start the comment loop at session start")
}
grok := strings.Index(mcpInstructions, "Grok Build and Claude Code")
other := strings.Index(mcpInstructions, "Other agents")
if grok < 0 || other < 0 || other <= grok {
Expand Down