Write Changelog

Generate a changelog for recent changes by reviewing merged PRs since the last changelog.

Usage

/changelog

What It Does

Finds Latest Changelog

• Checks your changelog directory (e.g., docs/internal/changelog/ or $CHANGELOG_DIR )

• Identifies most recent changelog by date in filename

Fetches Recent PRs

• Uses GitHub API to get all PRs merged to main since last changelog

• Extracts PR titles, descriptions, and metadata

Generates New Changelog

• Creates markdown file with date in filename

• Formats according to project conventions

Changelog Format

The changelog follows this structure:

1-3 Most Impactful Changes (heading 2 each)

• Title: 1-3 words describing the change

• Description: 1-2 sentences explaining the change

• Placeholder for visual (screenshot/diagram)

Summary of Smaller Changes (if applicable)

• High-level bullets for minor updates

Focus

• User-facing changes and new features

• Breaking changes highlighted prominently

• Major bug fixes and improvements

• Skip internal refactors unless significant

Example Structure

Changelog - 2026-01-07

Advanced Filtering

Added support for complex filter expressions in the query interface. Users can now combine multiple conditions using AND/OR operators and apply filters across related tables.

[Placeholder for screenshot]

Performance Boost

Optimized query execution engine reduces average query time by 60% for large datasets through intelligent caching and parallel processing.

[Placeholder for screenshot]

Additional Updates

• Fixed authentication timeout issues in Safari
• Improved error messages for failed data source connections
• Updated UI styling for better accessibility

Notes

• Requires GitHub CLI (gh ) to be installed and authenticated

• Changelog saved to your changelog directory (e.g., docs/internal/changelog/YYYY-MM-DD.md )

• Focuses on user impact, not technical implementation details