changelog

name	changelog
description	Generates a changelog by analyzing git history and tags. Use when the user asks to generate, write, or update a changelog.

Changelog Generation

Critical Rules

• Analyze all git tags and categorize commits by type (feat, fix, docs, chore, etc.)
• Create sections: Added, Fixed, Changed, Documentation
• Include unreleased changes at the top
• Store at project root as changelog.md
• Follow Keep a Changelog format

Git Commands

git tag --sort=-version:refname                          # all tags (newest first)
git describe --tags --abbrev=0                           # most recent tag
git log --oneline --no-merges $(git describe --tags --abbrev=0 2>/dev/null || echo "")..HEAD  # unreleased
git log --oneline --no-merges <prev-tag>..<current-tag>  # between two tags

Filter by Conventional Commit Type

git log --oneline --grep="^feat:" <tag1>..<tag2>    # Features
git log --oneline --grep="^fix:" <tag1>..<tag2>     # Bug fixes
git log --oneline --grep="^docs:" <tag1>..<tag2>    # Documentation
git log --oneline --grep="BREAKING" <tag1>..<tag2>  # Breaking changes