[Reply To Review Comments] Planning: Add reply_to_review_comment tool

[lossyrob]

Planning Artifacts for Reply To Review Comments Feature

This Planning PR contains the specification, research, and implementation plan for adding a reply_to_review_comment MCP tool to enable AI agents to respond directly within pull request review comment threads.

Deliverables

• Spec.md: Feature specification with user stories, requirements, and success criteria
• SpecResearch.md: Research on GitHub API behavior, permissions, and constraints
• CodeResearch.md: Documentation of implementation patterns, file locations, and integration points
• ImplementationPlan.md: 4-phase implementation plan with specific changes, success criteria, and verification steps
• WorkflowContext.md: Workflow metadata and configuration
• Prompt templates: Agent invocation prompts for subsequent workflow stages

Implementation Overview

The plan adds a new MCP tool following established patterns in pkg/github/pullrequests.go:

1. Phase 1: Core tool implementation with parameter validation and error handling
2. Phase 2: Toolset registration in the pull_requests write tools
3. Phase 3: Unit tests with toolsnap validation and e2e test coverage
4. Phase 4: Documentation generation and validation scripts

Key Technical Details

• Uses go-github v79 CreateCommentInReplyTo(ctx, owner, repo, number, body, commentID) method
• Parameters: owner, repo, pull_number, comment_id, body (all required)
• Returns MinimalResponse with reply ID and URL
• Integrates with existing pull_request_read tool for obtaining comment IDs
• Follows REST client patterns with ghErrors.NewGitHubAPIErrorResponse error handling

References

• Issue: Add ability to reply to individual pull request review comments github/github-mcp-server#1323
• Artifacts: .paw/work/reply-to-review-comments/

---

🐾 Generated with PAW