# release

Carries a guide release through the whole chain: semver bump, drafted changelog, count checks across docs, landing sync, commit and push.

- command · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 6529 repo stars
- Author: FlorianBruniaux
- License: CC-BY-SA-4.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/FlorianBruniaux/claude-code-ultimate-guide/tree/HEAD/.claude/commands/release.md
- Updated: 2026-10-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/commands/florianbruniaux-release

## What it 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.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/commands/release.md` — Call it with /release. For all projects use ~/.claude/commands/

### Codex

**Manually: put the files in place**
- File: `~/.codex/prompts/release.md` — Call it with /prompts:release. Codex marks this format deprecated in favour of skills

### GitHub Copilot

**Manually: put the files in place**
- File: `.github/prompts/release.prompt.md`

### Gemini CLI

**Manually: put the files in place**
- File: `.gemini/commands/release.toml` — Gemini stores commands as TOML: the prompt text goes into the prompt field

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/FlorianBruniaux/claude-code-ultimate-guide/tree/HEAD/.claude/commands/release.md

## When to use it
- bump the guide version with a semver rule
- draft a changelog entry from diff and commit log
- reconcile quiz and template counts across `README.md` and `llms.txt`
- sync version and content into the landing repo and MCP package
- commit and push both repositories in one run

## Example prompts
- /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`

## Similar
- [release-skills](https://affpapa.org/en/nevibecode/skills/release-skills.md) — skill · 26100 installs
- [release-manager](https://affpapa.org/en/nevibecode/skills/borghei-release-manager.md) — skill · 132 installs
- [release-bumper](https://affpapa.org/en/nevibecode/skills/release-bumper.md) — skill · 105 installs
- [herald](https://affpapa.org/en/nevibecode/agents/herald.md) — subagent · ★ 3951 repo stars
- [team-release](https://affpapa.org/en/nevibecode/skills/sametcelikbicak-team-release.md) — skill · ★ 71 repo stars
- [github-release](https://affpapa.org/en/nevibecode/skills/github-release.md) — skill · 741 installs

## Other versions with the same name
- [release · davila7](https://affpapa.org/en/nevibecode/commands/release.md) — 1664 installs
- [release · devin-axis](https://affpapa.org/en/nevibecode/commands/devin-axis-release.md) — ★ 7523 repo stars
- [release · davila7](https://affpapa.org/en/nevibecode/commands/davila7-release.md) — 228 installs

From the same set: [florianbruniaux/claude-code-ultimate-guide](https://affpapa.org/en/nevibecode/by/florianbruniaux/claude-code-ultimate-guide.md) — 45 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
