Skip to content

Commit ead6d01

Browse files
phurynclaude
andcommitted
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>
1 parent ce56422 commit ead6d01

1 file changed

Lines changed: 10 additions & 1 deletion

File tree

CLAUDE.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -89,7 +89,16 @@ See `README.md § Install` for the full per-platform matrix.
8989

9090
## Publishing
9191

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`.
95+
2. `npm test` (337-test floor, all green) + `tsc -p . --noEmit` clean.
96+
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.)
93102

94103
## Repo conventions
95104

0 commit comments

Comments
 (0)