Skip to content

Note the sticky closing-issue links in the PR-workflow skill - #518

Merged
JackKelly merged 1 commit into
mainfrom
claude/skill-note-closing-issue-refs
Aug 10, 2026
Merged

Note the sticky closing-issue links in the PR-workflow skill#518
JackKelly merged 1 commit into
mainfrom
claude/skill-note-closing-issue-refs

Conversation

@JackKelly

Copy link
Copy Markdown
Member

🤖 This PR description was written by Claude Code, acting on Jack's behalf.

Adds a "check what the merge will close" step to the github-issue-pr-workflow skill.

Why

When #514 merged, it took
issue 512 down with it — an issue that PR had deliberately left alone, and whose body said as much
("Two things noticed in passing, filed rather than fixed"). Issue 512 has since been reopened, with
its project Status put back to Todo.

A closing reference turns out to be sticky. GitHub registers the link when text containing the
keyword is first saved, and does not drop it when that text is edited away. An early draft of
#514's body must have carried one; by merge time no trace remained in either the body or the
branch's five commit messages, yet the link was still live:

$ gh pr view 514 --json closingIssuesReferences --jq '.closingIssuesReferences[].number'
228
512

So that field is the only reliable check. Reading the body is not evidence, and neither is grepping
the commits.

I confirmed the stickiness on this PR's own first attempt, which used the word "closed" directly
before a link to the issue and so registered the same link. Editing the phrase out left the
reference in place ninety seconds later, which is why this PR was opened afresh rather than edited.

What the note says

The command to run before gh pr merge, why the current body cannot be trusted, and how to
recover — because reopening is not the whole of it. The board automation moves a closed issue to
Done, and a reopen lands it on In Progress, not back on Todo, so the project field has to be
set explicitly.

Merging PR #514 closed #512, which its body said had been filed rather than fixed. The link
came from an earlier draft of the body: GitHub registers a closing reference when the text is
first saved and keeps it after the text is edited away, so neither the current body nor the
branch's commit messages show it. `gh pr view <N> --json closingIssuesReferences` is the only
thing that does.

Also records the recovery, since reopening is not the whole of it: the board automation moves a
closed issue to Done, and a reopen lands on In Progress rather than Todo.

Co-Authored-By: Claude <noreply@anthropic.com>
@JackKelly JackKelly added the documentation Improvements or additions to documentation label Aug 10, 2026
@JackKelly JackKelly self-assigned this Aug 10, 2026
@JackKelly
JackKelly merged commit 77c41ce into main Aug 10, 2026
2 checks passed
@JackKelly
JackKelly deleted the claude/skill-note-closing-issue-refs branch August 10, 2026 19:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant