// Analyze git commits in a range by examining actual code diffs (not commit titles) and produce a ranked list of improvements and optimizations. Use when the user wants a changelog, wants to summarize recent changes, asks what changed since a commit, or wants to review project progress.
| name | changelog-analyzer |
| description | Analyze git commits in a range by examining actual code diffs (not commit titles) and produce a ranked list of improvements and optimizations. Use when the user wants a changelog, wants to summarize recent changes, asks what changed since a commit, or wants to review project progress. |
Analyze all code changes between two git commits and produce a ranked summary of improvements and optimizations based on actual code diffs, not commit messages.
e0be0387a636a93a062cee621fd78b83dfccb06eHEADIf the user specifies a different range, use their values.
# List all commits in range (inclusive of start)
git log --oneline <start>~1..HEAD
# Get overall stats
git diff --stat <start>~1..HEAD
The diff may be very large. Process it in logical batches by directory or feature area:
# Get diff for a specific path
git diff <start>~1..HEAD -- <path>
# Or per-commit diffs when granularity matters
git show --stat <commit-hash>
git show <commit-hash> -- <file>
Key analysis areas (check each):
apps/web/src/components/ — UI components, UX improvementsapps/web/src/services/ — Service layer, storage, transcriptionapps/web/src/core/ and apps/web/src/lib/ — Core logic, utilitiesapps/web/src/hooks/ — React hooks, state managementapps/web/src/stores/ — Zustand stores, state architectureapps/web/src/types/ — Type definitions, data model changesapps/web/src/app/ — Pages, routes, API endpointspackages/ — Shared packagesFor each meaningful change found in the diffs, classify it into one of these categories:
| Category | Icon | Description |
|---|---|---|
| New Feature | ✨ | Entirely new capability added |
| Performance | ⚡ | Speed, memory, or rendering optimization |
| Bug Fix | 🐛 | Corrected broken or incorrect behavior |
| UX Improvement | 🎨 | Better user experience, UI polish |
| Refactor | ♻️ | Code restructuring without behavior change |
| Architecture | 🏗️ | Structural or design pattern improvement |
| DX / Tooling | 🔧 | Developer experience, build, CI/CD |
| i18n | 🌐 | Internationalization, localization |
| Security | 🔒 | Security hardening |
| Cleanup | 🧹 | Dead code removal, dependency cleanup |
Rate each change on impact (1-5):
| Score | Criteria |
|---|---|
| 5 | Core feature, affects most users, or prevents data loss |
| 4 | Significant feature or major UX/perf improvement |
| 3 | Notable improvement, moderate user impact |
| 2 | Minor enhancement, affects subset of users |
| 1 | Cosmetic, cleanup, or internal-only change |
Output a markdown report with this structure:
# Changelog: <start-hash-short>..<end-hash-short>
**Period**: <first-commit-date> → <last-commit-date>
**Commits**: <count> | **Files changed**: <count> | **+<insertions> / -<deletions>**
---
## Key Changes (by importance)
### ⭐⭐⭐⭐⭐ Critical / High Impact
#### ✨ [Feature/Change Title]
- **What changed**: Concise description based on actual code diff
- **Files**: List of key files modified
- **Impact**: Why this matters to users or the codebase
### ⭐⭐⭐⭐ Significant
...
### ⭐⭐⭐ Notable
...
### ⭐⭐ Minor
...
### ⭐ Cosmetic / Internal
...
---
## Summary Statistics
| Category | Count |
|----------|-------|
| New Features | X |
| Performance | X |
| Bug Fixes | X |
| ... | ... |
git diff or git show to see what really changed.