Project Release

Project Release

Releases ris-claude-code with semantic versioning, changelog updates, and GitHub releases.

Pre-release Checklist

Copy and check off:

- [ ] All changes committed
- [ ] Version bump determined
- [ ] READMEs need update? (only if skills list changed)
- [ ] All skill folders have SKILL.md + READMEs

Version Rules

Get current version:

git describe --tags --abbrev=0

Files Decision Matrix

Release Workflow

Step 1: Update CHANGELOG.md

## [X.Y.Z] - YYYY-MM-DD

### Added
- New feature

### Changed
- Updated feature

### Fixed
- Bug fix

Update comparison links at bottom:

[Unreleased]: https://github.com/serejaris/ris-claude-code/compare/vX.Y.Z...HEAD
[X.Y.Z]: https://github.com/serejaris/ris-claude-code/compare/vPREV...vX.Y.Z

Step 2: Update READMEs (if needed)

Only if skills list changed. Update both:

• README.md (English)
• README.ru.md (Russian)

Step 3: Commit

git add -A && git commit -m "docs: update changelog for vX.Y.Z"

Step 4: Tag

git tag -a vX.Y.Z -m "Release vX.Y.Z"

Step 5: Push

git push && git push --tags

Step 6: GitHub Release

gh release create vX.Y.Z \
  --title "vX.Y.Z — Short Description" \
  --notes "$(cat <<'EOF'
## Added/Changed
- Item 1
- Item 2

**Full Changelog**: https://github.com/serejaris/ris-claude-code/compare/vPREV...vX.Y.Z
EOF
)"

Post-release Verification

- [ ] Tag visible: git tag -l | tail -1
- [ ] Release on GitHub: gh release view vX.Y.Z
- [ ] CHANGELOG links work

Common Mistakes