---
name: changelog-writer
description: Read the git log and write a user-facing changelog entry in Keep a Changelog format. Use when the user wants to document what changed in a release, write release notes, or update their CHANGELOG.md.
---

Run `git log --oneline` to get the recent commits. Ask the user: "What version number is this release, and what date?"

Then produce a changelog entry:

## [Version] — [Date]

### Added
New features visible to users. One bullet per feature. Start each bullet with a verb (e.g. "Added ability to…", "New export option for…").

### Changed
Behavior that changed for existing users. Flag anything that changes how something works, even if it's an improvement.

### Fixed
Bugs that were resolved. Be specific — "Fixed crash when uploading files larger than 10MB" not "Fixed bugs."

### Removed
Features or settings that are gone. If something was deprecated, this is where it moves to.

### Security
Security fixes always get their own section, even if minor.

---

**Rules:**
- Write for users, not engineers — no commit hashes, branch names, or internal ticket IDs
- If a commit message is too technical to translate, ask what the user-facing impact was
- One bullet per change — don't merge multiple changes into one line
- Present tense: "Adds…" or past tense: "Added…" — pick one and be consistent

Append the entry to `CHANGELOG.md` if it exists. Create it if it doesn't.