changelog

Context

• Latest tag: !git describe --tags --abbrev=0 2>/dev/null || echo "No tags found"
• Commits since last tag: !TAG=\git describe --tags --abbrev=0 2>/dev/null || echo "HEAD~20"`; git log "$TAG"..HEAD --format="%h %s" 2>/dev/null | head -15 || echo "No commits found"`
• Repository: !basename \git rev-parse --show-toplevel 2>/dev/null` 2>/dev/null || echo "unknown"`

If $ARGUMENTS is empty or not provided:

Generate a changelog from commits since the last release tag.

Usage: /changelog [starting-point]

Examples:

• /changelog - Since last tag
• /changelog v1.2.0 - Since specific tag
• /changelog HEAD~50 - Last 50 commits
• /changelog 2024-01-01 - Since date

Workflow:

1. Find the latest git tag
2. Parse commits using Conventional Commits format
3. Group by type (Added, Fixed, Changed, etc.)
4. Generate Keep a Changelog formatted output

Proceed with commits since last tag.

---

If $ARGUMENTS is provided:

Generate a changelog from git commits since the specified starting point.

Configuration

• Since: $ARGUMENTS (tag, commit ref, or date)

Steps

1. Identify Release Points

   • Find the latest tag: git describe --tags --abbrev=0 2>/dev/null || echo ""
   • If $ARGUMENTS provided, use as starting point
   • If no tags exist, use first commit or a reasonable limit (last 100 commits)

2. Gather Commits Run: git log <since>..HEAD --format="%H|%s|%b|%an|%ae" --reverse

   For each commit, extract:

   • Hash (for linking)
   • Subject line
   • Body (for breaking changes, closes/fixes references)
   • Author info

3. Parse Conventional Commits Categorize commits into Keep a Changelog sections:

   Conventional Commit	Changelog Section
   feat:, feature:	Added
   fix:, bugfix:	Fixed
   perf:	Changed (Performance)
   refactor:	Changed
   docs:	Changed (Documentation)
   BREAKING CHANGE:	Changed (Breaking)
   deprecate:	Deprecated
   remove:	Removed
   security:	Security
   chore:, build:, ci:, test:	(Skip or group as "Other")