claude-mem/.claude/skills/version-bump/SKILL.md

name, description

name	description
version-bump	Manage semantic version updates for claude-mem project. Handles patch, minor, and major version increments following semantic versioning. Updates package.json, marketplace.json, and plugin.json. Creates git tags and GitHub releases. Auto-generates CHANGELOG.md from releases.

Version Bump Skill

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

Version Types

• PATCH (x.y.Z): Bug fixes only
• MINOR (x.Y.0): New features, backward compatible
• MAJOR (X.0.0): Breaking changes

Files to Update (ALL THREE)

1. package.json (line 3)
2. .claude-plugin/marketplace.json (line 13)
3. plugin/.claude-plugin/plugin.json (line 3)

Workflow

# 1. Check current version
grep '"version"' package.json .claude-plugin/marketplace.json plugin/.claude-plugin/plugin.json

# 2. Update all 3 files to new version (use Edit tool)

# 3. Verify consistency
grep '"version"' package.json .claude-plugin/marketplace.json plugin/.claude-plugin/plugin.json

# 4. Build
npm run build

# 5. Commit version files
git add package.json .claude-plugin/marketplace.json plugin/.claude-plugin/plugin.json
git commit -m "chore: bump version to X.Y.Z"

# 6. Create tag
git tag -a vX.Y.Z -m "Version X.Y.Z"

# 7. Push
git push origin main && git push origin vX.Y.Z

# 8. Create GitHub release (use your detailed release notes here)
gh release create vX.Y.Z --title "vX.Y.Z" --notes "RELEASE_NOTES_HERE"

# 9. Generate CHANGELOG.md from releases
gh api repos/thedotmack/claude-mem/releases --paginate | node -e "
const releases = JSON.parse(require('fs').readFileSync(0, 'utf8'));
const lines = ['# Changelog', '', 'All notable changes to claude-mem.', ''];
releases.slice(0, 50).forEach(r => {
  const date = r.published_at.split('T')[0];
  lines.push('## [' + r.tag_name + '] - ' + date);
  lines.push('');
  if (r.body) lines.push(r.body.trim());
  lines.push('');
});
console.log(lines.join('\n'));
" > CHANGELOG.md

# 10. Commit CHANGELOG
git add CHANGELOG.md
git commit -m "docs: update CHANGELOG.md for vX.Y.Z"
git push origin main

# 11. Discord notification
npm run discord:notify vX.Y.Z

Checklist

• Ultrathink + write detailed release notes
• All 3 files have matching version
• npm run build succeeds
• Git tag created (vX.Y.Z format)
• GitHub release created with detailed notes
• CHANGELOG.md updated
• Discord notification sent (if webhook configured)