AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

changelog-generator

Use when cutting a release, writing CHANGELOG.md or deciding the next version from commits, before writing notes by hand. Lints commits with commit_linter.py, picks the semver bump with version_bumper.py and renders notes with generate_changelog.py.

Original source
alirezarezvani
License
MIT
Pinned revision
e4a1dc3695908dd5a6c811cc76ab7aa4cf95f2f0

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read alirezarezvani--changelog-generator at revision e4a1dc3695908dd5a6c811cc76ab7aa4cf95f2f0, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 7

references/monorepo-strategy.md

Monorepo Changelog Strategy

Approaches

| Strategy | When to use | Tradeoff | |----------|-------------|----------| | Single root changelog | Product-wide releases, small teams | Simple but loses package-level detail | | Per-package changelogs | Independent versioning, large teams | Clear ownership but harder to see full picture | | Hybrid model | Root summary + package-specific details | Best of both, more maintenance |

Commit Scoping Pattern

Enforce scoped conventional commits to enable per-package filtering:

feat(payments): add Stripe webhook handler
fix(auth): handle expired refresh tokens
chore(infra): bump base Docker image

Rules:

  • Scope must match a package/directory name exactly
  • Unscoped commits go to root changelog only
  • Multi-package changes get separate scoped commits (not one mega-commit)

Filtering for Package Releases

# Generate changelog for 'payments' package only
git log v1.3.0..HEAD --pretty=format:'%s' | grep '^[a-z]*\(payments\)' | \
  python3 scripts/generate_changelog.py --next-version v1.4.0 --format markdown

Ownership Model

  • Package maintainers own their scoped changelog
  • Platform/infra team owns root changelog
  • CI enforces scope presence on all commits touching package directories
  • Root changelog aggregates breaking changes from all packages for visibility