Skip to content

Add issue triage instructions for finding closeable issues#1

Open
theosanderson-agent wants to merge 5 commits intoloculus-project:mainfrom
theosanderson-agent:main
Open

Add issue triage instructions for finding closeable issues#1
theosanderson-agent wants to merge 5 commits intoloculus-project:mainfrom
theosanderson-agent:main

Conversation

@theosanderson-agent
Copy link
Copy Markdown
Collaborator

Summary

  • Adds issue-triage.md documenting the process for scanning open issues against merged PRs to find closeable ones
  • Emphasizes avoiding common mistakes discovered during a real triage of loculus-project/loculus (667 open issues):
    • Citing PRs that were closed without merging (7 occurrences out of 38 proposals)
    • Citing PRs merged before the issue was created (1 occurrence)
    • Missing intentional reopens by maintainers
  • Includes specific gh CLI commands for GraphQL and timeline API queries
  • Provides a validation checklist to run before proposing any closure

Test plan

  • Review the instructions for completeness and clarity
  • Verify the gh CLI commands work against a real repository

🤖 Generated with Claude Code

theosanderson and others added 5 commits February 13, 2026 15:46
Documents the process for scanning open issues against merged PRs,
with emphasis on avoiding common mistakes: citing unmerged PRs,
citing PRs merged before the issue was created, and missing
intentional reopens by maintainers. Includes specific gh CLI
commands and a validation checklist.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
… closeable ones

PRs with closing keywords auto-close issues on merge. If the issue is
still open, a maintainer reopened it. Reframed step 1 as building an
exclusion list rather than a candidate list.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
PR metadata can be misleading. The actual code is the ground truth.
Added instructions to read the relevant source files and confirm the
fix is still present (not reverted, rewritten, or on a non-default
branch). This is the most important validation step.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
The closingIssuesReferences API only finds issues that were auto-closed
and reopened, which is not actionable for triage. Removed the step
entirely and renumbered.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Comments, labels, and closures are visible to the whole project and
cannot be easily undone. Always present findings to the user first
and wait for explicit approval before posting anything.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
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.

2 participants