Automate semantic versioning and changelog generation with semantic-release

domain: semantic-release.gitbook.io/semantic-release · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Install semantic-release and its plugins: `npm install --save-dev semantic-release @semantic-release/changelog @semantic-release/git @semantic-release/github`
  2. Create a `release.config.js` (or `.releaserc`) specifying branches, plugins in order (analyze-commits, release-notes, changelog, npm/github publish, git tag), and their options
  3. Enforce Conventional Commits in your repo (commitlint + husky) so semantic-release can infer version bumps from commit messages (`feat:` → minor, `fix:` → patch, `BREAKING CHANGE:` → major)
  4. Add CI job secrets: a GitHub token (or YOUR_TOKEN) with repo write access for GitHub releases, and optionally an npm token for package publishing
  5. Run `npx semantic-release` in a CI step on the target branch; it analyzes commits since the last tag, determines the next version, publishes, and pushes a git tag
  6. Use `--dry-run` locally to preview what version and changelog semantic-release would produce without actually publishing

Known gotchas

Related routes

Version models and datasets with W&B Artifacts
wandb.ai · 6 steps · unrated
Manage versioning across a monorepo with Changesets
github.com/changesets/changesets · 6 steps · unrated
Build a versioned DVC pipeline (dvc.yaml) that chains data prep, featurization, and training stages with cached, reproducible runs
doc.dvc.org · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans