release-management

Release Management

Automate releases with gh release, semantic versioning, and changelog generation.

CC ≥ 2.1.118 (M122): claude plugin tag <version> validates the plugin manifest hierarchy (marketplace.json, plugin.json, package.json, version.txt) before tagging. Runs --dry-run in CI before release-please opens its release PR; catches manifest drift early. See src/skills/chain-patterns/references/plugin-tag.md.

CRITICAL: Task Management is MANDATORY (CC 2.1.16)

BEFORE doing ANYTHING else, create tasks to track progress:

# 1. Create main task IMMEDIATELY
TaskCreate(
  subject="Release: {version}",
  description

Quick Reference

Create Release

List & View Releases

Verify Releases (gh CLI 2.86.0+)

Manage Releases

Semantic Versioning

Release Workflows

Standard and hotfix release procedures using git tags and gh release.

Load Read("references/release-workflows.md") for step-by-step standard and hotfix release workflows.

Changelog Generation

Auto-generated from PRs, custom .github/release.yml templates, and manual CHANGELOG.md format.

Load Read("references/changelog-generation.md") for changelog template examples and Keep-a-Changelog format.

Release Automation & Checklist

GitHub Actions workflow for tag-triggered releases, version bumping script, and pre/post-release checklist.

Load Read("references/release-automation.md") for CI workflow, bump script, and release checklist.

Best Practices

1. Use semantic versioning - Communicate change impact
2. Draft releases first - Review notes before publishing
3. Generate notes from PRs - Accurate, automatic history
4. Close milestone on release - Track completion
5. Tag main only - Never tag feature branches
6. Announce breaking changes - Prominent in release notes

Related Skills

• ork:github-operations: Milestones, issues, and CLI reference
• ork:github-operations: Branch management and git operations

References

Load on demand with Read("references/<file>"):