release · florianbruniaux — Claude Code slash command: version release flow
Carries a guide release through the whole chain: semver bump, drafted changelog, count checks across docs, landing sync, commit and push.
CC-BY-SA-4.0 ★ 6,529 updated 2026-10-22
.claude/commands/release.mdWhat release does
This command walks a guide through a release. Pass patch, minor or major; it reads VERSION, applies the semver rule and writes the new number back. A clean working tree stops it early, because git status runs first.
The changelog is drafted, not generated. The command inspects git diff --stat, git log --oneline and the touched files, then shows the entry and waits for your approval before inserting it. Quiz question and template counts are recalculated in README.md, llms.txt and llms-full.txt, with a grep gate to catch copies that drifted apart. Then ./scripts/sync-version.sh runs.
Hardcoded paths are the catch: the steps point at the author's own machine (/Users/florianbruniaux/Sites/perso/...), so a different checkout breaks at the landing sync. npm publish for the MCP package cannot be undone, and the command asks before it fires. Git, npm and the repo scripts have to exist.
What it helps with
- bump the guide version with a semver rule
- draft a changelog entry from diff and commit log
- reconcile quiz and template counts across
README.mdandllms.txt - sync version and content into the landing repo and MCP package
- commit and push both repositories in one run
Example prompts for the agent
- /release patch — bump the version and show me the changelog draft before writing it
- /release minor — run the release and ask me before
npm publish
How to install release
Manually: put the files in place
.claude/commands/release.mdCall it with /release. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/release.mdCall it with /prompts:release. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/release.prompt.mdManually: put the files in place
.gemini/commands/release.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about release
How to install release in Claude Code?
Copy the command file to .claude/commands/release.md inside your project. The /release patch call is then available in the session.
What does release do?
Validates the argument and repo state, bumps the version, prepares a CHANGELOG.md entry, recounts metrics, syncs the landing site and commits to both repositories.
Will it work on my own repository?
The landing and MCP steps are tied to the author's directories (/Users/florianbruniaux/Sites/perso/...). On another checkout you have to repoint those paths.
Similar slash commands
All slash commands for DevOps and infrastructure →release by other authors comes first.