Base directory for this skill: /Users/soph/Work/entire/devenv/git-sync/.claude/skills/changelog

Changelog Generation

Generate a changelog entry for a new release by analyzing merged PRs since the last tag.

Parameters

The user provides:

Find the previous release tag: git tag --sort=-version:refname | head -1
List all merge commits since that tag: git log <tag>..HEAD --merges --format='%s' | grep -v "Merge branch"
Get PR details with: gh pr list --state merged --base main --search "merged:><tag-date>" --json number,title,author --limit 50
List contributors: git log <tag>..HEAD --format='%an' --no-merges | sort | uniq -c | sort -rn

To determine if a contributor is external, check for an @entire.io email:

If they have an @entire.io email anywhere in git history, they are internal. Only list external contributors in the Thanks section.

Also check the memory file at memory/project_team_members.md for known internal/external mappings.

Insert the new version section at the top of CHANGELOG.md, after the header and before the previous version.

Follow the existing style in CHANGELOG.md exactly:

Sections: Added, Changed, Fixed, Housekeeping, Thanks. Omit empty sections.
Each bullet: starts with a dash, concise description, PR link(s) at the end
Group related PRs into a single bullet when they're part of the same feature/fix
Work-in-progress features: call out explicitly, e.g., "Feature X (work in progress): ..."
Known limitations: note inline, e.g., "Note: subagent tracking is not yet supported due to..."
Thanks section: only external contributors. Name what they contributed specifically.
Dependency bumps: group into a single Housekeeping bullet unless a bump fixes a notable bug
PR links: always use full URL format [#N](https://github.com/entireio/git-sync/pull/N)
No trailing period on bullet items
Date: use the current date in YYYY-MM-DD format

Added: new features, new commands, new agent integrations, new CI workflows
Changed: behavior changes, API changes, UX changes, migrations
Fixed: bug fixes, E2E fixes, agent-specific fixes
Housekeeping: dependency bumps, docs, refactors, CI improvements, test improvements

Added the 0.6.0 entry (dated 2026-06-03) to the top of CHANGELOG.md:

Added — git-sync convert-sha256 subcommand (#66)
Changed — deferred credential helper / git-style auth flow (#65); streaming bootstrap commit-graph fetch with memory wins (#61)
Fixed — materialized push against CDN-fronted HTTP targets (#64)
Housekeeping — go-git bump to alpha.4 (#60)

Notes:

No Thanks section — all contributors (Andrea Nodari @entire.io, Soph, and computermode) are internal.
Omitted PR #62 ("Remove checkpoints version 2 setting") — it only edits this repo's .entire/settings.json dogfooding config, not git-sync behavior, so it's not user-facing. Let me know if you'd rather list it under Housekeeping.