Skip to content

fix(#809): disambiguate scope clause in correctness sub-agent - #810

Open
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/809-correctness-scope-disambiguation
Open

fix(#809): disambiguate scope clause in correctness sub-agent#810
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/809-correctness-scope-disambiguation

Conversation

@fullsend-ai-coder

Copy link
Copy Markdown
Contributor

Summary

  • Disambiguate the "Do not own: PR scope" clause in the correctness sub-agent to clarify it means "don't judge whether the PR's scope is appropriate" (intent-coherence's job), NOT "suppress correctness findings about files outside the diff"
  • Add "Cross-variant parity" as an explicit check pattern alongside consumer-completeness and removal/rename-staleness, directing the sub-agent to verify sibling variants remain consistent when the diff modifies one variant

Context

On PR #752, the correctness sub-agent identified that the GitLab variant of the issue-labels skill was missing a trigger phrase added to the GitHub variant, but suppressed the finding as "outside PR scope." A human reviewer had flagged the same gap. The sub-agent's "Do not own: PR scope" clause was being misinterpreted as license to suppress any finding about files not in the diff, when it should only mean the sub-agent should not judge whether the PR's scope is right or wrong.

Testing

  • Verified make check-bundle passes (this change does not touch any bundled scripts)
  • No automated tests exist for sub-agent prompt files; validation criteria are behavioral (described in the issue)

Closes #809

Post-script verification

  • Branch is not main/master (agent/809-correctness-scope-disambiguation)
  • Secret scan passed (gitleaks — 693ed83bbd5289e1ef13d6c7a3772f61efc43c86..HEAD)
  • PR body secret scan passed (gitleaks — no-git)

The correctness sub-agent was suppressing valid beyond-diff findings
by reasoning they were "outside PR scope" — a dimensional filter
it does not own. Two changes fix this:

1. Add a disambiguation paragraph after the "Do not own: PR scope"
   clause clarifying that the clause means "don't judge whether
   the PR's scope is appropriate" (intent-coherence's job), not
   "suppress correctness findings about files outside the diff."

2. Add "Cross-variant parity" as an explicit check pattern
   alongside consumer-completeness and removal/rename-staleness,
   directing the sub-agent to verify sibling variants remain
   consistent when the diff modifies one variant.

Note: pre-commit could not run (sandbox network policy blocked
git fetch during hook environment setup). Bundle check passed.

Closes #809
@fullsend-ai-coder
fullsend-ai-coder Bot requested a review from a team as a code owner August 14, 2026 19:27
@fullsend-ai-coder fullsend-ai-coder Bot added the ready-for-review Triggers review agent dispatch label Aug 14, 2026
@fullsend-ai-review

fullsend-ai-review Bot commented Aug 14, 2026

Copy link
Copy Markdown

🤖 Finished Review · ✅ Success · Started 7:28 PM UTC · Completed 7:38 PM UTC

Commit: cb37099 · View workflow run →

@fullsend-ai-review

Copy link
Copy Markdown

Review

Findings

Medium


Labels: PR modifies a review sub-agent definition under skills/pr-review/sub-agents/

@fullsend-ai-review fullsend-ai-review Bot added requires-manual-review Review requires human judgment review-agent labels Aug 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ready-for-review Triggers review agent dispatch requires-manual-review Review requires human judgment review-agent

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Correctness sub-agent should not suppress beyond-diff findings under scope reasoning it does not own

0 participants