Skip to content

fix(pr-skill): move changelog phase after PR creation#934

Merged
sirtimid merged 4 commits intomainfrom
sirtimid/fix-pr-skill-changelog-ordering
Apr 15, 2026
Merged

fix(pr-skill): move changelog phase after PR creation#934
sirtimid merged 4 commits intomainfrom
sirtimid/fix-pr-skill-changelog-ordering

Conversation

@sirtimid
Copy link
Copy Markdown
Contributor

@sirtimid sirtimid commented Apr 14, 2026

Summary

The changelog update phase needs the PR number to create proper links (e.g. [#123]) in entries. Previously, changelogs were updated in Phase 4 before the PR was created in Phase 5, making it impossible to include the PR link.

  • Swap Phase 4 (changelogs) and Phase 5 (PR creation) so the PR number is available when writing changelog entries
  • Add explicit emphasis on key updating-changelogs.md rules that were being missed: consumer-perspective thinking, combining like changes, splitting disparate changes, and linking the PR number

Testing

This is a docs-only change to a Claude Code skill definition. Verified the final file reads correctly with proper phase ordering and emphasis.

🤖 Generated with Claude Code


Note

Low Risk
Docs-only change to the PR-creation skill workflow; minimal risk beyond process/labeling instructions potentially being followed incorrectly.

Overview
Reorders the pr Claude skill workflow so the PR is created in Phase 4 before changelog updates, ensuring the PR number is available for changelog links.

Adds explicit Phase 5 guidance to either apply a no-changelog label for non-consumer-facing changes or update changelogs with emphasized rules (consumer-focused wording, combining/splitting entries, and linking the PR) before presenting results.

Reviewed by Cursor Bugbot for commit d817845. Bugbot is set up for automated code reviews on this repo. Configure here.

Changelog entries need the PR number for links (e.g. `[#123]`), so they
must be written after the PR is created, not before. Also adds stronger
emphasis on consumer-perspective thinking and combining like changes, per
the updating-changelogs.md instructions.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@sirtimid sirtimid requested a review from a team as a code owner April 14, 2026 16:28
@sirtimid sirtimid added the no-changelog Indicates that no changelog updates are required, and that related CI checks should be skipped. label Apr 14, 2026
When a PR has no consumer-facing changes, the skill now adds the
`no-changelog` label instead of silently skipping. This prevents
CI changelog validation failures.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@sirtimid sirtimid enabled auto-merge April 14, 2026 16:32
Copy link
Copy Markdown

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit f4f372f. Configure here.

Comment thread .claude/skills/pr/SKILL.md Outdated
Move the "return PR URL" instruction out of Phase 4 and into a final
"Done" section after Phase 5, so an agent following the instructions
sequentially won't interpret "Return" as a signal to end the workflow
before updating changelogs.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@rekmarks
Copy link
Copy Markdown
Member

@grypez did you have an idea for forcing the agent to do what we want by means of a bash invocation?

@grypez
Copy link
Copy Markdown
Contributor

grypez commented Apr 15, 2026

@grypez did you have an idea for forcing the agent to do what we want by means of a bash invocation?

image

Seems to be more trouble than it's worth. Also, passing context from agent to subagent is not supported via this method without building more infrastructure.

Copy link
Copy Markdown
Contributor

@grypez grypez left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@sirtimid sirtimid added this pull request to the merge queue Apr 15, 2026
Merged via the queue into main with commit ce9b92a Apr 15, 2026
21 checks passed
@sirtimid sirtimid deleted the sirtimid/fix-pr-skill-changelog-ordering branch April 15, 2026 17:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

no-changelog Indicates that no changelog updates are required, and that related CI checks should be skipped.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants