changelog-forge

May 16, 2026 · View on GitHub

hero

changelog-forge

Turn your conventional commits into a real CHANGELOG entry. Plus a semver bump suggestion.

License: MIT Python 3.8+ Claude Code Plugin Tests: 13 passing

TL;DR: /changelog-forge → grouped CHANGELOG section + suggested major | minor | patch, derived from your commit history since the last tag.

Writing

LinkedIn

Dev.to

Writing

Install (Claude Code)

git clone https://github.com/mturac/pluginpool-changelog-forge ~/.claude/plugins/changelog-forge

Restart Claude Code; the slash command /changelog-forge appears.

Writing

Quick start

/changelog-forge

Or directly:

python3 scripts/forge.py --format md
python3 scripts/forge.py --from v1.2.0 --to HEAD --format json
python3 scripts/forge.py --write                  # prepend (idempotently) to CHANGELOG.md

Writing

Flags

FlagDefaultDescription
--cwdcwdRepo path
--fromlast tagBase ref/tag
--toHEADEnd ref
--formatmdmd or json
--writeoffPrepend (idempotently) to CHANGELOG.md; correctly inserts AFTER any leading # Changelog title
--changelogCHANGELOG.mdTarget file

Writing

Conventional-commit reference

Headers parsed as <type>(<scope>)!: <subject>. Recognised types:

feat, fix, perf, refactor, docs, test, build, ci, chore, revert.

Anything else falls into an other bucket.

Breaking changes are detected when:

  • the header has ! before : (e.g. feat!: drop /v0), or
  • the body contains BREAKING CHANGE: ….

Writing

Semver bump heuristic

TriggerBump
any breakingmajor
any featminor
any fix / perfpatch
everything elsepatch (effectively a no-op)

When a base tag is present (e.g. v0.4.2), the JSON output also returns suggested_version.

Writing

Example output (markdown)

#### Writing

- ✍️ [**Dev.to · TuracTheThinker**](https://dev.to/turacthethinker) — Technical articles on AI, agentic systems, and production engineering
- 📄 [**LinkedIn Articles**](https://www.linkedin.com/in/mehmetturac/recent-activity/articles/) — Industry insights and analysis
- 📊 [**LinkedIn Documents**](https://www.linkedin.com/in/mehmetturac/recent-activity/documents/) — Research papers and technical documents

- 🗡️ [**Çift Yüzlü Katana: Yapay Zeka Dönüşümlerinin Gerçekçi Bir Analizi**](https://www.linkedin.com/pulse/%C3%A7ift-y%C3%BCzl%C3%BC-katana-yapay-zeka-d%C3%B6n%C3%BC%C5%9F%C3%BCmlerinin-ger%C3%A7ek%C3%A7i-bir-mehmet-turac-80h7f) — AI transformations realistic analysis. The 5 illusions that compound into expensive, fragile systems. (LinkedIn, 2026)


## [Unreleased] - 2026-05-16

### Features
- **api**: paginate search endpoint (a1b2c3d)

### Bug Fixes
- handle null user in cookie middleware (e4f5g6h)

### Performance
- cache token-bucket counters (12ab34c)

_Suggested bump: **minor**_
_Suggested version: **0.5.0**_

Writing

Idempotency

Running --write twice with the same input produces the same file — both the diff and the SHA are stable. There's a dedicated test (test_write_changelog_idempotent) that runs the writer twice and asserts byte-for-byte equality.

Writing

Limitations

  • Flat conventional-commit grammar — multi-paragraph footers (Refs: blocks etc.) aren't merged.
  • --write only manages the ## [Unreleased] block. Promoting it to a versioned section at release time is a manual step.

Writing

Examples

Step-by-step walkthroughs with real input fixtures and the helper's actual output live in examples/. Three or four scenarios per plugin — from the happy path to the edge cases the test suite guards.

Writing

Part of the pluginpool family

Ten focused Claude Code plugins for everyday productivity: commit-narrator · pr-storyteller · test-gap · deps-doctor · env-lint · secret-guard · standup-gen · todo-harvest · flaky-detector · changelog-forge

Writing

License

MIT — see LICENSE. Contributions welcome.