Skip to content

docs(release): push the version tag by name, not every local tag - #736

Merged
tractorjuice merged 1 commit into
mainfrom
docs/release-push-single-tag
Aug 4, 2026
Merged

tractorjuice merged 1 commit into
mainfrom
docs/release-push-single-tag

Conversation

@tractorjuice

Copy link
Copy Markdown
Owner

Cutting v6.8.0 published a stray tag. Step 11 of the release flow prescribes git push --tags, which pushes every tag in the local repo, not just the one just created:

* [new tag]  pre-rebase-251256b9 -> pre-rebase-251256b9
* [new tag]  v6.8.0 -> v6.8.0

pre-rebase-251256b9 was a local backup tag from May 2026 that had never been pushed. It is now deleted from the remote, and this stops the next release recreating the problem.

Change

docs/RELEASING.md step 11 and the matching step 9 in .claude/skills/release/SKILL.md both become:

git push && git push origin vX.Y.Z

Both carry a comment naming the v6.8.0 incident, so the shorter form does not get restored as a tidy-up later.

Scope

git push --tags appeared in exactly two places repo-wide, both fixed here. scripts/tag-plugins.sh was already correct — it pushes each native plugin tag by name.

Note on the deleted tag

Checked before deleting: the commit 251256b9 was an ancestor of no branch and referenced by no other tag, so that tag was its only reference. The work it backed up ("read desktop_notifications from env var, not user_config substitution") did survive its rebase and is live on main — plugins/arckit-claude/hooks/notify-stale-artifacts.mjs:39 reads CLAUDE_PLUGIN_OPTION_DESKTOP_NOTIFICATIONS, and the plugin CHANGELOG records it. Nothing unique was lost.

🤖 Generated with Claude Code

https://claude.ai/code/session_01WdKpn9PEjXtYiyRoG3Y7or

Step 11 prescribed `git push --tags`, which pushes every tag in the local
repo. Cutting v6.8.0 carried up a stray `pre-rebase-251256b9` backup tag
that had been sitting locally since May, publishing it to the public repo
alongside the release.

Both the doc and the /release skill now push the single tag by name. The
comment records the v6.8.0 incident so the next person does not "simplify"
it back.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WdKpn9PEjXtYiyRoG3Y7or
@tractorjuice
tractorjuice merged commit e931b88 into main Aug 4, 2026
2 checks passed
@tractorjuice
tractorjuice deleted the docs/release-push-single-tag branch August 4, 2026 19:29
@tractorjuice tractorjuice added the documentation Improvements or additions to documentation label Aug 31, 2026
@tractorjuice tractorjuice self-assigned this Aug 31, 2026
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