Skip to content

ci: tighten auto-review prompt + add accepted-trade-offs list#23

Merged
cgoulart35 merged 1 commit into
masterfrom
ci/tune-auto-review
Jun 13, 2026
Merged

ci: tighten auto-review prompt + add accepted-trade-offs list#23
cgoulart35 merged 1 commit into
masterfrom
ci/tune-auto-review

Conversation

@cgoulart35

Copy link
Copy Markdown
Owner

What

Tunes the automated Claude PR reviewer to cut noise and re-litigation, and adds a durable "what to ignore" list it reads.

Why

Reviewing the bot's history (PRs #16–22) surfaced four issues, all prompt/process — not model capability:

Changes

.github/workflows/claude-review.yml (prompt only):

  • Scope strictly to the PR's diff; don't audit pre-existing code/deps.
  • Confidence bar: real bug/security/regression only; zero comments is a valid outcome.
  • Tag findings 🔴 must-fix / 🟠 should-fix; no nits, praise, or speculative hardening.
  • Honor CLAUDE.md's accepted trade-offs; never "correct" a documented decision.
  • Update one summary in place (--edit-last --create-if-none) instead of one per push.

CLAUDE.md:

  • New "Review scope — accepted trade-offs" list the reviewer reads — the human-in-the-loop ignore-memory. Seeded with the werkzeug prod server, in-memory sessions, self-signed cert, camelCase, mutable @vN action tags (so upstream fixes land ASAP), and the 401-by-design self-review failure.

Model unchanged (Pro default / Sonnet 4.6) — Opus would phrase the same out-of-scope nits more eloquently and draws extra paid usage on Pro.

Notes

  • This PR edits the review workflow, so it fails its own review by design (401 Workflow validation failed) — expected, ignorable, doesn't block merge.
  • Both files are docs/CI-excluded by the changes filter, so merging won't rebuild the image or redeploy the Pi. The new prompt takes effect on the next code PR.

🤖 Generated with Claude Code

Scope the Claude PR reviewer to the diff, set a confidence bar (real
bug/security/regression only), tag findings must-fix/should-fix, drop
nits/praise, and update one summary in place (gh pr comment --edit-last
--create-if-none) instead of stacking a new comment per push. Honor
CLAUDE.md's accepted trade-offs and never "correct" a documented decision.

Add a "Review scope - accepted trade-offs" list to CLAUDE.md (the reviewer
reads it) as the human-in-the-loop ignore-memory, seeded with the settled
decisions: werkzeug prod server, in-memory sessions, self-signed cert,
camelCase, mutable @vn action tags, and the 401-by-design self-review fail.

Model unchanged (Pro default / Sonnet) - the issues were prompt/scope, not
capability.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@cgoulart35
cgoulart35 merged commit 7815449 into master Jun 13, 2026
4 of 5 checks passed
@cgoulart35
cgoulart35 deleted the ci/tune-auto-review branch June 13, 2026 18:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant