changelog-writer

---

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.