LLMSkillHub
mirroredCopied from NahumLitvin/prismantis under MIT. NahumLitvin has not claimed this page, and is not affiliated with LLM SkillHub.

nahumlitvin / release

Cut a prismantis release - version bump, changelog, verify, tag and push. Use when asked to "release", "bump the version", "ship 0.x" or "publish".

0
SKILL.md
2.0 KB

Release

  1. Pick the version. Breaking option or token renames are minor while below 1.0 (and major after). New features are minor. Fixes are patch.
  2. Set it in both manifests: version in .claude-plugin/plugin.json and plugins[0].version in .claude-plugin/marketplace.json.
  3. Changelog: rename ## [Unreleased] at the top of docs/CHANGELOG.md to a dated ## [x.y.z], keeping Added, Changed and Fixed, written for users. Merged PRs already put their entries there.
  4. Vendor: if scripts/package.json changed, run npm --prefix scripts run build:vendor, and confirm the bundle has no import statements and no non-MIT code (grep -c -i elk hooks/vendor/*.js must print 0).
  5. Verify: run every step in AGENTS.md Verify, plus live-check.

  6. Fresh install test against a throwaway config:
    `
    CLAUDECONFIGDIR=<scratch>/fresh claude plugin marketplace add NahumLitvin/prismantis
    CLAUDECONFIGDIR=<scratch>/fresh claude plugin install prismantis@prismantis
    CLAUDECONFIGDIR=<scratch>/fresh claude plugin list
    `
    Run it after pushing; the marketplace clones from GitHub.

  7. Release PR: main only takes merges through a PR with green checks, so open the release commit as a PR and merge it.
  8. Tag main: git tag vX.Y.Z <merge commit> && git push origin vX.Y.Z. The release workflow checks the tag against plugin.json, checks the tag is on main, and publishes the GitHub release from the CHANGELOG section.
  9. Pin the release: a second PR sets ref to vX.Y.Z and sha to the tagged commit in the source of .claude-plugin/marketplace.json. Until it merges, installs keep getting the previous release.
  10. Confirm CI and the release workflow are green, then run the fresh install test and check claude plugin list shows the new version.