release-description

name	release-description
description	Generate a release description by analyzing commit titles since the last git tag. Use when the user asks to prepare release notes, update changelog, or describe what's in a new version.

Release Description

Generate a release summary by analyzing commits since the last tag.

Steps

1. Find the latest release tag

git tag --sort=-creatordate | head -1

2. List commit titles since that tag

git log --oneline <tag>..HEAD

If there are no commits since the tag, stop — nothing to update.

3. Analyze the commits

Categorize by Conventional Commits prefix:

Prefix	Category
feat:	New features
fix:	Bug fixes
perf:	Performance improvements
refactor:	Refactors / internal changes
chore:, docs:, ci:	Maintenance (mention only if significant)
No prefix	Read the title to infer category

4. Write the summary

Compose a concise release description. Rules:

• Start with "This version..." or "This release..."
• Be concise — a few sentences, not a full changelog
• Highlight the most impactful changes — lead with the biggest features or fixes
• Group similar changes — e.g. "several bug fixes" instead of listing each one
• Use plain language — this is user-facing, not developer-facing

5. Report

Display the release description to the user for review.