claude-code-plugin-release

name	claude-code-plugin-release
description	Automated semantic versioning and release workflow for Claude Code plugins. Handles version increments across package.json, marketplace.json, and plugin.json, build verification, git tagging, GitHub releases, and changelog generation.

Version Bump & Release Workflow

IMPORTANT: You must first plan and write detailed release notes before starting the version bump workflow.

CRITICAL: ALWAYS commit EVERYTHING (including build artifacts). At the end of this workflow, NOTHING should be left uncommitted or unpushed. Run git status at the end to verify.

Preparation

1. Analyze: Determine if the change is a PATCH (bug fixes), MINOR (features), or MAJOR (breaking) update.
2. Environment: Identify the repository owner and name (e.g., from git remote -v).
3. Paths: Verify existence of package.json, .claude-plugin/marketplace.json, and plugin/.claude-plugin/plugin.json.

Workflow

1. Update: Increment version strings in all configuration files.
2. Verify: Use grep to ensure all files match the new version.
3. Build: Run npm run build to generate fresh artifacts.
4. Commit: Stage all changes including artifacts: git add -A && git commit -m "chore: bump version to X.Y.Z".
5. Tag: Create an annotated tag: git tag -a vX.Y.Z -m "Version X.Y.Z".
6. Push: git push origin main && git push origin vX.Y.Z.
7. Release: gh release create vX.Y.Z --title "vX.Y.Z" --notes "RELEASE_NOTES".
8. Changelog: Regenerate CHANGELOG.md using the GitHub API and the provided script:

   gh api repos/{owner}/{repo}/releases --paginate | ./scripts/generate_changelog.js > CHANGELOG.md
   

9. Sync: Commit and push the updated CHANGELOG.md.
10. Notify: Run npm run discord:notify vX.Y.Z if applicable.
11. Finalize: Run git status to ensure a clean working tree.

Checklist

• All config files have matching versions
• npm run build succeeded
• Git tag created and pushed
• GitHub release created with notes
• CHANGELOG.md updated and pushed
• git status shows clean tree