diff --git a/CLAUDE.md b/CLAUDE.md index 5ed6a15..457b63a 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -108,6 +108,10 @@ at a merge boundary.** "`TOOL_VERSION` bumped", "no schema change, no migration". Silence is ambiguous; "none" is information. This repo's changelog is how future-you learns whether a deploy costs two hours. +- **Releases are cut on judgement, not on a schedule or a merge.** `Unreleased` + is the staging area for whatever is going into the next release; when enough + has accumulated to be worth shipping, it gets a number and a date. Nothing + about a merge to `dev` triggers a release. - **Cutting a release** is its own `chore(release): vX.Y.Z — ` commit on `dev`, renaming `## Unreleased` → `## vX.Y.Z — YYYY-MM-DD` and touching: `CHANGELOG.md`, `pyproject.toml`, the version line in `CLAUDE.md` and