Skip to content

docs(release): make tag-push the canonical release path#130

Merged
dean0x merged 1 commit into
mainfrom
docs/release-tag-push-canonical
Jun 28, 2026
Merged

docs(release): make tag-push the canonical release path#130
dean0x merged 1 commit into
mainfrom
docs/release-tag-push-canonical

Conversation

@dean0x

@dean0x dean0x commented Jun 28, 2026

Copy link
Copy Markdown
Owner

Summary

Documents the tag-push release flow as canonical and flags the
workflow_dispatch -f version= path as currently broken. Surfaced during the
v0.3.0 release, where the dispatch path failed GH006 (the prepare job can't push
the release commit to protected main), left an orphaned tag, and published
nothing — v0.3.0 ultimately shipped via tag-push.

Changes

Docs only — no code or workflow changes.

Related

The `workflow_dispatch -f version=` path fails GH006 — its prepare job can't
push the release commit to protected `main`, so it leaves an orphaned tag and
publishes nothing. Tag-push is the path that actually ships releases (v0.1.0–
v0.3.0). Update CLAUDE.md, RELEASING.md, and .release/RELEASE-FLOW.md to lead
with tag-push and flag the dispatch path as blocked.

Refs #127

Co-Authored-By: Claude <noreply@anthropic.com>
@dean0x dean0x merged commit 3aaf491 into main Jun 28, 2026
10 checks passed
@dean0x dean0x deleted the docs/release-tag-push-canonical branch June 28, 2026 20:40
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