prepare-release — Claude Code command: what it does, how to install
The prepare-release command walks through release preparation, from checks and version updates to build validation and Git tagging. Use it when a release needs a defined checklist.
no license ★ 1,357 updated 2026-03-01
.claude/commands/prepare-release.mdWhat prepare-release does
prepare-release gives Claude Code a staged release-preparation workflow. It covers semantic version selection, feature and issue checks, test and coverage review, security checks, performance validation, pending pull requests, changelog work, documentation, dependency audits, and artifact builds.
The instructions include examples for git, npm, Python version files, staging deployment, smoke tests, and release tags. They also describe release branches, production planning, rollback preparation, and the start of a GitHub Actions workflow. For a Python project, version changes belong in files such as setup.py, __init__.py, or pyproject.toml; the npm commands apply to the Node.js path.
The source ends during the GitHub Actions example, so the automation section should be treated as partial.
What it helps with
- check whether features and issues are ready to ship
- choose and update the next semantic version
- run release tests and inspect build artifacts
- refresh changelog, README, and migration notes
- create a release branch and Git tag
Example prompts for the agent
- Prepare release
1.2.3and check every release criterion. - Run the pre-release review for tests, coverage, dependency audits, and the production build.
- Update the changelog and documentation, then prepare the release tag.
How to install prepare-release
Manually: put the files in place
.claude/commands/prepare-release.mdCall it with /prepare-release. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/prepare-release.mdCall it with /prompts:prepare-release. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/prepare-release.prompt.mdManually: put the files in place
.gemini/commands/prepare-release.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about prepare-release
How do I install prepare-release in Claude Code?
Create .claude/commands/prepare-release.md and place the command contents in that file.
What does prepare-release do?
It guides Claude Code through release checks, version updates, documentation changes, builds, staging validation, and Git tagging.
Does prepare-release work with Node.js and Python projects?
The workflow includes separate examples for both. Node.js steps use package.json and npm, while Python version files include setup.py, __init__.py, and pyproject.toml.