bump-version

Bump Version Command

You automate the version bump ritual for the PSD Plugin Marketplace. There are three independent version tracks — never conflate them.

Bump type: $ARGUMENTS

Version Track Reference

Track	Files	When to bump
Marketplace	.claude-plugin/marketplace.json → metadata.version; CLAUDE.md → **Version**; root README.md	Every release
psd-coding-system	plugins/psd-coding-system/.claude-plugin/plugin.json; marketplace.json → plugins[name=psd-coding-system].version; plugins/psd-coding-system/README.md	Only when coding system skills/agents changed
psd-productivity	plugins/psd-productivity/.claude-plugin/plugin.json; marketplace.json → plugins[name=psd-productivity].version; plugins/psd-productivity/README.md	Only when productivity skills/agents changed

Phase 1: Determine Bump Type

BUMP_TYPE="$ARGUMENTS"

case "$BUMP_TYPE" in
  patch|minor|major) echo "Bump type: $BUMP_TYPE" ;;
  *)
    echo "Invalid or missing bump type"
    ;;
esac

If the argument is empty or invalid, use AskUserQuestion to ask which bump type they want.

Phase 2: Determine Which Plugins Changed

Use AskUserQuestion to ask:

• Did psd-coding-system skills or agents change in this release?
• Did psd-productivity skills or agents change in this release?

The marketplace version always bumps. Plugin versions only bump for their own changes.

Phase 3: Read Current Versions

# Marketplace version (always bumps)
MARKETPLACE_VERSION=$(jq -r '.metadata.version' .claude-plugin/marketplace.json)
echo "Marketplace current: $MARKETPLACE_VERSION"

# Plugin versions (only if those plugins changed)
CODING_VERSION=$(jq -r '.version' plugins/psd-coding-system/.claude-plugin/plugin.json)
PRODUCTIVITY_VERSION=$(jq -r '.version' plugins/psd-productivity/.claude-plugin/plugin.json)
echo "psd-coding-system current: $CODING_VERSION"
echo "psd-productivity current: $PRODUCTIVITY_VERSION"

Calculate new versions using the bump type:

bump_version() {
  local version="$1" type="$2"
  local major minor patch
  major=$(echo "$version" | cut -d. -f1)
  minor=$(echo "$version" | cut -d. -f2)
  patch=$(echo "$version" | cut -d. -f3)
  case "$type" in
    patch) echo "$major.$minor.$((patch + 1))" ;;
    minor) echo "$major.$((minor + 1)).0" ;;
    major) echo "$((major + 1)).0.0" ;;
  esac
}

NEW_MARKETPLACE=$(bump_version "$MARKETPLACE_VERSION" "$BUMP_TYPE")
# Only calculate if those plugins changed:
# NEW_CODING=$(bump_version "$CODING_VERSION" "$BUMP_TYPE")
# NEW_PRODUCTIVITY=$(bump_version "$PRODUCTIVITY_VERSION" "$BUMP_TYPE")

Phase 4: Update Files

Read each file before editing (required by Edit tool).

Always update (marketplace track):

1. .claude-plugin/marketplace.json — metadata.version only (use specific context to avoid matching plugin version lines)
2. CLAUDE.md — **Version**: X.Y.Z
3. README.md — badge and **Version**: X.Y.Z occurrences
4. CHANGELOG.md — Add new section at top (see Phase 5)

Only if psd-coding-system changed:

5. plugins/psd-coding-system/.claude-plugin/plugin.json — "version": "X.Y.Z"
6. .claude-plugin/marketplace.json — plugins[name=psd-coding-system].version (use surrounding context to target correctly)
7. plugins/psd-coding-system/README.md — Version: X.Y.Z

Only if psd-productivity changed:

8. plugins/psd-productivity/.claude-plugin/plugin.json — "version": "X.Y.Z"
9. .claude-plugin/marketplace.json — plugins[name=psd-productivity].version
10. plugins/psd-productivity/README.md — Version: X.Y.Z

CRITICAL for marketplace.json edits: The file has three version strings. Use sufficient surrounding context in Edit calls to uniquely target each one — never use replace_all: true on marketplace.json.

Phase 5: Update CHANGELOG

Use AskUserQuestion to ask for a brief description of what changed. Add entry at top of CHANGELOG.md:

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

### Added
- [New features if any]

### Changed
- [Changes to existing functionality if any]

### Fixed
- [Bug fixes if any]

Run date +%Y-%m-%d for today's date.

Phase 6: Update Skill/Agent Counts (if changed)

SKILL_COUNT=$(find plugins/psd-coding-system/skills -name 'SKILL.md' -type f | wc -l | tr -d ' ')
AGENT_COUNT=$(find plugins/psd-coding-system/agents -name '*.md' -type f | wc -l | tr -d ' ')
echo "Skills: $SKILL_COUNT"
echo "Agents: $AGENT_COUNT"

If counts differ from CLAUDE.md, update them. Otherwise skip.

Phase 7: Commit, Tag, Push

# Stage changed files
git add \
  .claude-plugin/marketplace.json \
  CLAUDE.md \
  README.md \
  CHANGELOG.md
  # + plugin-specific files if those plugins changed

git commit -m "chore: Bump version to $NEW_MARKETPLACE — [brief reason]"

git tag -a "v$NEW_MARKETPLACE" -m "Release v$NEW_MARKETPLACE - [brief summary]"

git push origin HEAD
git push origin "v$NEW_MARKETPLACE"

Phase 8: Summary

### Release v$NEW_MARKETPLACE

| Track | Old | New | Updated |
|-------|-----|-----|---------|
| Marketplace | $MARKETPLACE_VERSION | $NEW_MARKETPLACE | ✅ |
| psd-coding-system | $CODING_VERSION | $NEW_CODING or (unchanged) | ✅ / — |
| psd-productivity | $PRODUCTIVITY_VERSION | $NEW_PRODUCTIVITY or (unchanged) | ✅ / — |

**Tag:** v$NEW_MARKETPLACE
**Pushed:** ✅
**Cache:** Run `/reload-plugins` to activate