Release

Release Workflow

Detect changes, bump versions, and deploy individual plugin repos.

Step 1: Generate dist-repos

./scripts/generate-individual-repos.sh

Step 2: Detect changes

Compare each generated repo against the last deployed state in .repo-cache/:

for repo_dir in dist-repos/*/; do
  repo_name=$(basename "$repo_dir")
  cache_dir=".repo-cache/$repo_name"
  if [ -d "$cache_dir" ]; then
    changes=$(diff -rq --exclude='.git' "$cache_dir" "$repo_dir" 2>/dev/null)
    if [ -n "$changes" ]; then
      echo "CHANGED: $repo_name"
      echo "$changes"
    fi
  else
    echo "NEW: $repo_name"
  fi
done

If no repos have changes, tell the user "Nothing to release" and stop.

Step 3: Show change summary

For each changed repo, show a brief summary of what changed (files added/modified/removed).

Step 4: Ask about version bumps

For each changed repo, use AskUserQuestion to ask the user what kind of version bump to apply:

• patch (1.0.0 -> 1.0.1): Bug fixes, minor content updates
• minor (1.0.0 -> 1.1.0): New content, features, or significant updates
• major (1.0.0 -> 2.0.0): Breaking changes or complete rewrites

Step 5: Update source frontmatter

For each repo that needs a bump, update the version field in the source file:

• Skills: skills/<name>/SKILL.md
• Agents: agents/<name>.md

Use the Edit tool to change the version: line in the YAML frontmatter.

Compute the new version by parsing the current version: X.Y.Z and incrementing the appropriate part:

• patch: increment Z
• minor: increment Y, reset Z to 0
• major: increment X, reset Y and Z to 0

Step 6: Bump main plugin.json

Ask the user if they want to bump the main .claude-plugin/plugin.json version too (patch/minor/major/skip). Update the "version" field if they choose to bump.

Step 7: Regenerate dist-repos

Run the generate script again so dist-repos picks up the new versions:

./scripts/generate-individual-repos.sh

Step 8: Commit version bumps

Stage and commit all version changes in the main repo:

git add skills/ agents/ .claude-plugin/plugin.json
git commit -m "Bump versions for release

Co-Authored-By: Claude <noreply@anthropic.com>"

Step 9: Deploy

Run the deploy script to push individual repos to GitHub:

./scripts/deploy-individual-repos.sh

Step 10: Push main repo

git push origin main

Show the user a summary of what was released with the new version numbers.