← docsDocumentation

/changelog

Git commits → grouped changelog entries.

Generates changelog entries from recent git commits. Groups by type (feat, fix, refactor), formats for customer-facing or internal audiences.

Category

Documentation

Execution

git log → grouped entries

Goal

Produce a formatted changelog from git commit history.

Scope

Applies to

  • +Release preparation
  • +Sprint summaries
  • +Version bumps

Does not cover

  • −Detailed technical documentation
  • −API reference

Triggers

"Generate changelog""What changed since last release"Phase 11 of radioactive

Inputs

  • →Base tag or commit hash
  • →Head commit (default: HEAD)
  • →Audience: customer-facing or internal

Invariants

  • 01Must use actual git log — no fabrication
  • 02Group by conventional commit type
  • 03Customer-facing entries must be jargon-free

Procedure

  1. Step 1Determine commit range (tag or hash)
  2. Step 2Run git log --oneline between range
  3. Step 3Group commits: feat, fix, refactor, chore, docs
  4. Step 4Format entries for target audience
  5. Step 5Output changelog section

Outputs

  • ▸Formatted changelog entries grouped by type
  • ▸Optional: release notes summary

Review Gate

  • [ ]All commits in range are represented
  • [ ]No fabricated entries
  • [ ]Audience-appropriate language