Skip to content

docs: verify follow-up findings before reporting (workflow) - #195

Merged
s2x merged 1 commit into
mainfrom
docs/verify-followup-findings
Aug 8, 2026
Merged

docs: verify follow-up findings before reporting (workflow)#195
s2x merged 1 commit into
mainfrom
docs/verify-followup-findings

Conversation

@s2x

@s2x s2x commented Aug 8, 2026

Copy link
Copy Markdown
Contributor

Description

Extends the subagent workflow (docs/workflow.md) so that follow-up findings are verified before being reported — preventing duplicate or unverified issues (as happened in the #176 cycle, where a verification pass found 1 of 4 proposed findings was already covered by #180).

Changes

  • New subsection "Follow-up Candidate Verification" (under section 5): subagents must
    1. verify technical truth with file:line evidence (verdicts: CONFIRMED / PARTIALLY TRUE / FALSE — drop FALSE)
    2. scan ALL GitHub issues for duplicates — gh issue list --state all --limit 100 and pagination (--limit 30 is only gh's default, there may be more) + gh search issues keyword search → ALREADY TRACKED verdict with issue number
    3. report one line per finding: verdict, evidence, suggested label
  • Section 4 (coder) and section 5 (review): follow-up paragraphs now mandate the verification step; coder's "Final step" prompt extended
  • Quick Reference + Notes: updated to reflect the verification step and the pagination reminder

Testing

  • Docs-only change — no build/test needed

Code Review

- Add 'Follow-up Candidate Verification' subsection (section 5): subagents
  must check technical truth (file:line evidence) and scan ALL GitHub
  issues (--limit 100, paginate — 30 is just gh's default) for duplicates
  before proposing follow-up issues; verdicts CONFIRMED/PARTIALLY TRUE/
  FALSE/ALREADY TRACKED
- Apply the same rule to coder (section 4) and review (section 5)
- Update Quick Reference and Notes
@s2x s2x self-assigned this Aug 8, 2026
@s2x
s2x merged commit 6872f98 into main Aug 8, 2026
3 checks passed
@s2x
s2x deleted the docs/verify-followup-findings branch August 8, 2026 16:33
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