/changelog 0.8.0
Base directory for this skill: /Users/soph/Work/entire/devenv/cli_experiments/.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:
- Version number -- e.g.,
0.5.3 - Additional PRs -- optionally, PRs not yet merged that should be included
Step 1: Gather Data
- 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
Step 2: Identify External Contributors
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.
Step 3: Write the Entry
Insert the new version section at the top of CHANGELOG.md, after the header and before the previous version.
Format
Follow the existing style in CHANGELOG.md exactly:
Style Rules
- 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/cli/pull/N) - No trailing period on bullet items
- Date: use the current date in YYYY-MM-DD format
Categorization Guide
- 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
ARGUMENTS: 0.8.0
The changelog for 0.8.0 is written and renders cleanly. CHANGELOG.md now has a complete ## [0.8.0] - 2026-07-06 section at the top, covering all 43 PRs merged since v0.7.8, with @suhaanthayyil credited in Thanks as the sole external contributor.
Note: this release contains user-facing feature and behavior changes (e.g. control-plane output moving JSON behind --json, git-remote-entire migrating to jurisdiction tokens, review-timeout changes) — a minor bump to 0.8.0 fits, though if any of those are considered breaking you may want to double-check before tagging.
suhaan is now our intern
Done. Two changes:
- Changelog: dropped the
### Thankssection from the 0.8.0 entry — Suhaan was the only external contributor, so with him now internal there's no one to thank. His work (agent-help, experts, review timeouts) stays documented in Added/Changed as normal. - Team memory: moved
suhaanthayyilfrom the external list to internal (marked as intern, classified manually since his git email is still gmail), so future changelogs won't put him in Thanks.
The 0.8.0 section now ends at the Housekeeping dependency-bumps line.