You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Document the tag + GitHub Release step as the standing release procedure
Every release push to main must create an annotated vX.Y.Z tag and a matching
GitHub Release (the convention the v1.0.0… tag history already follows); this
was implicit and got missed for v1.3.1. Marketplace publish stays a separate,
explicit step.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: CLAUDE.md
+10-1Lines changed: 10 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -89,7 +89,16 @@ See `README.md § Install` for the full per-platform matrix.
89
89
90
90
## Publishing
91
91
92
-
Per-release: bump version in `package.json`, `npm test`, `npm run publish`. The `PawelHuryn` publisher is already registered and authenticated locally.
92
+
**Release procedure — ALWAYS tag + create a GitHub Release on a release push to `main`** (standing convention; mirrors the `v1.0.0…` tag history + GitHub Releases):
93
+
94
+
1. Bump `version` in `package.json` (user-initiated) and add the dated section to `changelog.md`.
3. Commit + push to `main` (direct-to-main, no feature branches).
97
+
4.**Annotated git tag**`vX.Y.Z` at the release commit → `git tag -a vX.Y.Z -m "Release vX.Y.Z"` → `git push origin vX.Y.Z`.
98
+
5.**GitHub Release** for that tag → `gh release create vX.Y.Z --title "Release vX.Y.Z" --notes-file <notes>` (notes = the new changelog section(s); include any earlier version that was bumped but never released).
99
+
6.**Marketplace publish is separate and explicit** — only `npm run publish` (vsce) when the user asks. The `PawelHuryn` publisher is registered + authenticated locally; publishing ≠ tagging.
100
+
101
+
Don't skip the tag/release on a release push. (A pure mid-dev version bump that isn't a release — e.g. the unreleased v1.3.0 voice iteration — is the only exception.)
0 commit comments