From bf38418721358d1587da5e500f6e98e933e01841 Mon Sep 17 00:00:00 2001 From: priosshrsth Date: Wed, 19 Aug 2026 11:48:22 +0000 Subject: [PATCH] docs: record that release tag names cannot be reused Immutable releases burn a tag name when a release publishes under it, so v0.0.6 could not be recreated after its release was deleted. Skipping to 0.0.7. Release-As: 0.0.7 --- .claude/CLAUDE.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md index d8e0ce9..a188a10 100644 --- a/.claude/CLAUDE.md +++ b/.claude/CLAUDE.md @@ -38,6 +38,12 @@ specific version, put `Release-As: 1.2.3` in a commit footer. `src/version.ts` carries an `x-release-please-version` marker so it is bumped alongside `package.json`; `tests/version.test.ts` fails if the two ever drift. +Immutable releases are enabled on this repository, so a tag name is burned permanently the +moment a release publishes under it — deleting the release and the tag does not free the +name, and release-please fails with `tag_name was used by an immutable release`. Never +reuse a version number; skip to the next one. `v0.0.6`, `v0.05` and `v3.0.0` are already +spent this way. + ## Documentation Rules After any significant code change, update the following: