feat: improve Claude Code Review workflow instructions

[filippofilip95]

• Focus on high-value issues: bugs, security, performance, breaking changes
• Add guidelines for concise, actionable feedback
• Fix permissions: pull-requests write (required for gh pr comment)

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
sendvelo	Building	Preview, Comment	Dec 22, 2025 8:35pm

[claude]

PR Review: ✅ Approved

This PR correctly improves the Claude Code Review workflow with focused, high-value changes.

Key Improvements

1. Fixed Permissions (.github/workflows/claude-code-review.yml:24) - Correctly changed pull-requests: read → write to enable gh pr comment functionality. This was blocking the workflow from posting reviews.

2. Streamlined Prompt - Excellent refinement focusing on:

   • High-value issues (bugs, security, performance, breaking changes)
   • Concise, actionable feedback over style nitpicks
   • Clear guidelines for constructive reviews
   • Removed redundant context (REPO/PR NUMBER) that gh CLI already provides

Code Quality

• No security concerns
• No performance issues
• No breaking changes
• Changes are minimal and well-scoped

Minor Note

The prompt references "CLAUDE.md" but the actual file is at approval-tool/claude.md. This should work fine since Claude can search for it, but consider updating the reference for clarity in future iterations if needed.

Verdict: This PR is ready to merge. The permission fix resolves a critical blocker, and the prompt improvements will lead to better, more focused code reviews.