Skip to content

CLAUDE.md: a release is tagged where it lands on main - #30

Merged
KennethGrace merged 1 commit into
mainfrom
docs/releases
Oct 13, 2026
Merged

KennethGrace merged 1 commit into
mainfrom
docs/releases

Conversation

@KennethGrace

Copy link
Copy Markdown
Contributor

Lumen got its first tag today: v0.8.0, annotated, on edf6a5a — the merge of #29, which completed 0.8.0 together with #28. Downstream projects can now pin lumen @ git+https://github.com/latticedynamics/lumen.git@v0.8.0 instead of a path, so a result names the exact Lumen that produced it.

Nothing in CLAUDE.md said how a release becomes a tag, so the next version bump wouldn't get one. This adds a Releases section that writes down the practice the 0.8.0 tag followed. It doesn't invent a new one.

What it says

  • The version is bumped by the releasing PR's last commit, titled with what the version is. This is the existing practice: 0.8.0 — a state holds only itself, and a step can give it up #29's last commit is 0.8.0 — ….
  • Tag the commit where the release lands on main, not the commit where the version was typed. 0.8.0 shows why they differ: the bump was written on feat/sdm-donate, state: a state returned by forward holds only itself #28 merged to main in between, and the release is the merge that contains both.
  • Annotated tags only, with the version's title and a line per change.
  • Push the tag by name. A plain git push doesn't send tags.
  • Never move or delete a published tag. A bad release gets a new patch version.

Versions before 0.8.0 stay untagged unless one is needed. The section says how to tag them retroactively.

Docs only. No code or test changes.

🤖 Generated with Claude Code

Lumen is now consumed by tag (v0.8.0 is the first), and nothing said how
a release becomes one. Writes down the practice the 0.8.0 tag followed:
version bumped by the releasing PR's last commit, an annotated tag on the
commit where the release lands on main, pushed by name, never moved.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@KennethGrace
KennethGrace merged commit 0e30566 into main Oct 13, 2026
8 checks passed
@KennethGrace
KennethGrace deleted the docs/releases branch October 13, 2026 18:02
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