---

name: release description: Bump version, commit, and tag a release

Release Workflow

Trigger on: "release", "bump version", "prepare release", "new version"

Instructions

When triggered, execute all steps (don't just show commands):

1. Determine version bump type from user input or ask:

   • patch (0.3.0 → 0.3.1) - bug fixes
   • minor (0.3.0 → 0.4.0) - new features
   • major (0.3.0 → 1.0.0) - breaking changes

2. Run the release script:

   Copybun run scripts/release.ts <type>
   

3. Stage all changes:

   Copygit add -A
   

4. Commit with version in message:

   Copygit commit -m "chore: release v<NEW_VERSION>"
   

5. Create annotated git tag with release notes:

   Copygit tag -a v<NEW_VERSION> -m "<RELEASE_NOTES>"
   

   Write release notes summarizing what's in this release:

   • Start with version header: v<VERSION> - <SHORT_TITLE>
   • Group changes under ## New Features, ## Bug Fixes, ## Technical, etc.
   • Be concise but descriptive
   • Look at commits since last tag: git log $(git describe --tags --abbrev=0)..HEAD --oneline

6. Push commits and tags:

   Copygit push && git push --tags
   

Example

User: "release patch" → Run script with patch → git add -A → git commit -m "chore: release v0.3.1" → git tag -a v0.3.1 -m "v0.3.1 - Bug Fixes\n\n## Bug Fixes\n- Fixed crash on startup\n- Fixed save corruption" → git push && git push --tags

Viewing Release Notes

Copy# View tag message
git tag -l -n99 v<VERSION>

# Create GitHub release from tag
gh release create v<VERSION> --notes-from-tag