claudekit/skills/git-workflows/references/changelogs.md

Changelog Generation

Keep a Changelog Format

Based on keepachangelog.com:

## [1.2.0] - 2026-04-19

### Added
- Password reset functionality (#123)
- Email verification for new accounts

### Changed
- Improved error messages for validation failures
- Updated dependencies to latest versions

### Fixed
- Race condition in session handling (#456)
- Incorrect timezone in date displays

### Removed
- Legacy v1 API endpoints (deprecated since 1.0)

Generating from Commits

# Get commits since last tag
git log --oneline $(git describe --tags --abbrev=0)..HEAD

# Group by type
git log --oneline --grep="^feat" $(git describe --tags --abbrev=0)..HEAD
git log --oneline --grep="^fix" $(git describe --tags --abbrev=0)..HEAD

Category Mapping

Commit Type	Changelog Category
feat	Added
fix	Fixed
refactor, perf	Changed
removal commits	Removed
docs	Usually omitted
chore, test, style	Usually omitted

User-Friendly Descriptions

Transform commit messages into user-facing descriptions:

BAD:  feat(auth): add pwd reset (#123)
GOOD: Password reset functionality — users can now reset their password via email (#123)

• Write for users, not developers
• Include PR/issue references
• Explain the user-visible impact