| name | release |
| description | Handles version bumps and npm releases for the swarm-tools monorepo (opencode-swarm-plugin,
claude-code-swarm-plugin, swarm-mail, swarm-queue). Use when: creating changesets, bumping
versions, preparing releases, checking release status, debugging publish failures, verifying
npm packages, or merging release PRs.
Triggers: "release", "publish", "changeset", "bump version", "ship it", "new version",
"create a release", "check npm", "verify publish", "/release"
|
Release Workflow
Standard Release (CI-driven)
All releases go through changesets → CI → npm. Never publish manually unless CI is broken.
1. Create changeset
cat > .changeset/<descriptive-name>.md << 'EOF'
---
"opencode-swarm-plugin": patch
---
fix: description of what changed and why
EOF
Bump levels: patch (bug fixes), minor (features), major (breaking changes).
Which packages to include — only packages with actual changes:
opencode-swarm-plugin — main plugin (CLI, MCP server, swarm orchestration)claude-code-swarm-plugin — thin Claude Code wrapper (commands, agents, hooks, skills)swarm-mail — agent messaging, memory, reservationsswarm-queue — task queue
Use pdf-brain for commit quotes:
pdf-brain search "<relevant topic>" --limit 1 --expand 500
2. Commit and push
git add .changeset/<name>.md <changed-files>
git commit -m
git push origin main
