git-tag

name	git-tag
description	Create semantic version git tags with changelog. Analyzes changes since last tag, suggests version bump, updates CHANGELOG.md, commits, and tags. Triggers on "release", "git tag", "new version", "bump version", "changelog".

Git Tag & Release

Create semantic version git tags with automatic changelog generation.

Workflow

1. Detect Current Version

git tag --sort=-v:refname | head -1

Parse the latest tag (e.g. v0.2.3 → {major: 0, minor: 2, patch: 3}).

If no tags exist, assume 0.0.0.

2. Analyze Changes Since Last Tag

git log --oneline <last_tag>..HEAD

If HEAD is at the last tag (no new commits), inform the user that there are no changes to release and stop.

Review each commit message to understand the scope and nature of changes.

3. Determine Version Bump

Based on conventional commit types in the log:

Commit type	Bump
feat! or BREAKING CHANGE	major (x.0.0)
feat	minor (0.x.0)
fix, build, ci, perf, refactor	patch (0.0.x)
docs, style, test, chore	patch (0.0.x)

Use the highest bump level found. If commits contain both feat and fix, use minor.

4. Ask User for Confirmation

Use the question tool to present the suggested version and ask for confirmation:

• Show the suggested version
• Show the changelog summary
• Allow the user to override the version (major/minor/patch)

Example question:

Changes since v0.2.3:

• feat: add user dashboard
• fix: correct rating calculation

Suggested version: v0.3.0 (minor bump) Do you want to proceed with this version?

Options: the suggested version, and alternative bumps (major, minor, patch).

5. Update CHANGELOG.md

Read the current CHANGELOG.md and insert a new version section at the top (after the header).

Format follows Keep a Changelog:

## [X.Y.Z] - YYYY-MM-DD

### Added
- Description of new features

### Changed
- Description of changes

### Fixed
- Description of fixes

### Removed
- Description of removed features

Group commits by category:

• Added: feat commits
• Changed: refactor, behavior-changing build/ci commits
• Fixed: fix commits
• Removed: revert or explicitly removed features

Rules:

• Write concise, user-facing descriptions (not raw commit messages)
• Merge related commits into a single changelog entry
• Skip empty categories
• Use today's date

6. Commit and Tag

git add CHANGELOG.md
git commit -m "docs: add CHANGELOG for v<X.Y.Z>"
git tag v<X.Y.Z>

7. Verify

git log --oneline -3
git tag --sort=-v:refname | head -3

Show the user the resulting commit and tag.

Guidelines

• NEVER push tags or commits to remote unless the user explicitly asks
• If there are uncommitted changes, warn the user and ask if they want to commit them first or ignore
• Always use the question tool for version confirmation — never assume
• Keep changelog entries concise and user-facing
• Follow conventional commit types for categorization