# changelog-generator

A subagent that turns git commits into a CHANGELOG.md and release notes, sorting changes by Conventional Commits. Handy right before you tag a version.

- subagent · `type=agent` · Claude Code · 1754 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/documentation/changelog-generator.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/agents/changelog-generator

## What it does

The subagent walks your git history and sorts commits into breaking changes, features, fixes and internal work. Parsing relies on Conventional Commits, so vague commit messages will not make it into a tidy summary. Breaking changes and migrations come first in the output.

Its toolset is small: `Read`, `Write`, `Edit` and `Bash`. It runs git itself, writes new files and edits an existing `CHANGELOG.md`. Output follows Keep a Changelog, with dates and version links. Beyond the changelog file it produces release notes with download links, migration guides for breaking changes, and scripts that generate the changelog automatically.

The author expects you to review the result: automate the generation, then curate the content. On a repo where commit messages follow no convention, expect little value until you agree on a template.

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --agent documentation/changelog-generator
```

2. **Manually: put the files in place**
- File: `.claude/agents/changelog-generator.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/changelog-generator.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/changelog-generator.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/documentation/changelog-generator.md

## When to use it
- build a CHANGELOG.md from commit history
- write release notes that highlight user-facing impact
- document a migration path for breaking changes
- group commits by category and impact
- set up commit message templates and a release workflow

## Example prompts
- Build a CHANGELOG.md from the commits in the last release
- Draft release notes for 2.0 and put breaking changes at the top
- Write a migration guide for the changes in the recent commits

## Similar
- [changelog-automation](https://affpapa.org/en/nevibecode/skills/changelog-automation.md) — skill · 13733 installs
- [deployment-engineer](https://affpapa.org/en/nevibecode/agents/deployment-engineer.md) — subagent · 6079 installs
- [launchdarkly-flag-cleanup](https://affpapa.org/en/nevibecode/agents/launchdarkly-flag-cleanup.md) — subagent · 171 installs
- [pr-test-analyzer](https://affpapa.org/en/nevibecode/agents/pr-test-analyzer.md) — subagent · ★ 44770
- [Technical Debt Remediation Plan](https://affpapa.org/en/nevibecode/agents/technical-debt-remediation-plan.md) — subagent · ★ 40451
- [TDD Red Phase - Write Failing Tests First](https://affpapa.org/en/nevibecode/agents/tdd-red-phase-write-failing-tests-first.md) — subagent · ★ 40451

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 495 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md