# /release - Release Notes & Changelog Generator

> Converts git commit histories into customer-facing changelogs.

Canonical: https://www.agentickit.co/commands/release
Last updated: 2026-11-18

Summarizes git commit history into customer-facing changelogs: categorizes features, bug fixes, and improvements with clear release notes.

**Usage:** `Use before deploying production updates to publish changelogs and release notes. For the PR text itself, use /pr-description first.`

## Pipeline
1. Parse git log since last semantic release tag
2. Categorize changes into Features, Enhancements, Bug Fixes, and Breaking Changes
3. Format customer-friendly descriptions highlighting user benefits
4. Update CHANGELOG.md and create GitHub Release announcement draft

## Output files
- `CHANGELOG.md`
- `docs/releases/vX.X.X.md`

**Claude Code frontmatter:** `argument-hint: [target environment, e.g. staging or production]` · `model: opus`

## Related
- [technical-writer](https://www.agentickit.co/agents/technical-writer)
- [tech-lead](https://www.agentickit.co/agents/tech-lead)
- [technical-docs](https://www.agentickit.co/skills/technical-docs)
- [project-conventions](https://www.agentickit.co/skills/project-conventions)
