Skip to content

chore: stop the review agent from manufacturing nits#41

Merged
dfa1 merged 1 commit into
mainfrom
chore/tune-reviewer-nits
Jun 27, 2026
Merged

chore: stop the review agent from manufacturing nits#41
dfa1 merged 1 commit into
mainfrom
chore/tune-reviewer-nits

Conversation

@dfa1

@dfa1 dfa1 commented Jun 27, 2026

Copy link
Copy Markdown
Owner

The zstd-reviewer agent's Blocker/Should-fix/Nit template pressured it to always return a non-empty list; once real issues were gone it padded with cosmetic nits it then told the author to ignore — noise, not signal.

  • Empty findings list is now an explicitly valid outcome ("APPROVE — nothing material")
  • Always report Blocker / Should-fix when they exist
  • Report a Nit only when genuinely worth a human acting on
  • "Coverage is not measured by finding count"

Agent-config only.

🤖 Generated with Claude Code

The reviewer's findings-template output pressured it to always produce a
list; once real issues were gone it padded with cosmetic nits (label
choices, inline FQNs) that the author was told to ignore. Make an empty
findings list an explicitly valid outcome, restrict Nits to ones worth a
human's time, and state that coverage is not measured by finding count.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@dfa1 dfa1 merged commit 8ff19b0 into main Jun 27, 2026
1 check passed
@dfa1 dfa1 deleted the chore/tune-reviewer-nits branch June 27, 2026 20:43
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