changeloglisted
Install: claude install-skill markbaindesign/bain-studio
# Changelog — Release Changelog Maintainer
Updates `CHANGELOG.md` at the project root using the [Keep a Changelog](https://keepachangelog.com) format. Run at release time before generating the client report or review checklist.
---
## Steps
### 1. Read existing changelog
Check if `CHANGELOG.md` exists at the project root:
```bash
ls CHANGELOG.md 2>/dev/null || echo "NOT FOUND"
```
If missing, create it with this header:
```markdown
# Changelog
All notable changes to this project are documented here.
Format: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
Versioning: [Semantic Versioning](https://semver.org/spec/v2.0.0.html)
```
### 2. Find the last release
```bash
git tag --sort=-version:refname | head -5
git log $(git describe --tags --abbrev=0 2>/dev/null || echo "")..HEAD --oneline 2>/dev/null || git log --oneline -20
```
If no tags exist, use all commits.
### 3. Read QA review-passed items
```bash
ls qa/qa-review-passed/ 2>/dev/null
```
Read each file for context on what was fixed or verified.
### 4. Read any release notes
Check for release notes in:
- `.claude/release-notes.md`
- `docs/release-notes.md`
Use if present — these take priority over raw git log.
### 5. Categorise changes
Group commits and QA items into Keep a Changelog categories:
| Category | What goes here |
|---|---|
| `Added` | New features, new pages, new functionality |
| `Fixed` | Bug fixes, broken functionality repaired |
| `Changed` | Updates to existing features, design