diff --git a/.github/workflows/claude-code-review.yml b/.github/workflows/claude-code-review.yml
index 8ee4bd1c2..13c04a3b0 100644
--- a/.github/workflows/claude-code-review.yml
+++ b/.github/workflows/claude-code-review.yml
@@ -51,10 +51,16 @@ jobs:
Use the repository's CLAUDE.md for guidance on style and conventions. Be constructive and helpful in your feedback.
- Use `gh pr comment` with your Bash tool to leave your review as a comment on the PR.
+ ## How to Comment:
+ 1. Before starting your review, read ALL existing comments on this PR using `gh pr view --comments` to see the full conversation
+ 2. If there are any previous comments from you (Claude), identify what feedback you've already provided
+ 3. Only provide NEW feedback that hasn't been mentioned yet, or updates to previous feedback if the code has changed
+ 4. Avoid repeating feedback that has already been given - focus on providing incremental value with each review
+ 5. For highlighting specific code issues, use `mcp__github_inline_comment__create_inline_comment` to leave inline comments
+ - When possible, provide actionable fix suggestions with code examples
+ 6. Use `gh pr comment` with your Bash tool to leave your overall review as a comment on the PR
+ 7. Wrap detailed feedback in Details
... tags, keeping only a brief summary visible
- Wrap detailed feedback in Details
... tags, keeping only a brief summary visible.
-
# See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
# or https://docs.claude.com/en/docs/claude-code/cli-reference for available options
claude_args: '--allowed-tools "mcp__github_inline_comment__create_inline_comment,Bash(gh issue view:*),Bash(gh search:*),Bash(gh issue list:*),Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*),Bash(gh pr list:*)"'