← ClaudeAtlas

releaselisted

Cut a clownhead release — bump the version in the three places that carry it, run the checks, commit, tag, push, and write the GitHub release notes. Use when asked to "make a release", "cut a release", "bump the version", "tag a version", or "publish" this project.
rooterkyberian/clownhead · ★ 0 · Code & Development · score 70
Install: claude install-skill rooterkyberian/clownhead
# Releasing clownhead clownhead is installed straight from git (`uv tool install git+https://github.com/rooterkyberian/clownhead`), so there is no package index step. A release is a version bump, a tag, and notes worth reading. ## 1. Start from a green main History on `main` is linear and committed to directly — no branch, no PR. ```bash git switch main && git pull --ff-only git status --short ``` Anything uncommitted is either part of this release or should be dropped before it starts. Then run the checks: ```bash mise run check ``` That is lint, typecheck and tests. `mise` installs its own toolchain and can fail on a sandboxed network before it ever reaches the project; when it does, run the same four commands directly rather than releasing unchecked: ```bash uv run ruff check . && uv run ruff format --check . && uv run mypy && uv run pytest ``` ## 2. Pick the number Pre-1.0, so the minor is where breakage goes: - **minor** (`0.2.0` → `0.3.0`) — a command or flag removed or renamed, a default flipped, anything that changes what an existing invocation does. - **patch** (`0.3.0` → `0.3.1`) — fixes and additions that leave every existing invocation alone. `git log --oneline $(git describe --tags --abbrev=0)..HEAD` is what is being released. ## 3. Bump all three The version lives in three files and they must move together: - `pyproject.toml` — `[project] version` - `src/clownhead/__init__.py` — `__version__`, which is what `clownhead --version` answers - `uv