{"id":"e67223fd-18d2-4c8d-b1ba-22a291fee273","task":"Manage versioning across a monorepo with Changesets","domain":"github.com/changesets/changesets","steps":["Initialize Changesets in the monorepo root: `npx changeset init` — this creates a `.changeset/` directory with config","When authoring a change, run `npx changeset` interactively to select affected packages and specify the bump type (major/minor/patch) and a summary; commit the generated markdown file alongside your code","In CI, run `npx changeset version` on the release branch to consume all pending changeset files, bump package.json versions, and update CHANGELOG.md files for each package","Review and merge the version PR that CI creates (the Changesets GitHub Action can automate PR creation and keep it updated as new changesets are added)","After merging the version PR, run `npx changeset publish` in CI to publish all bumped packages to npm (or your registry); the action tags each released package in Git","Configure `linked` packages in `.changeset/config.json` if multiple packages must always share the same version"],"gotchas":["If a developer forgets to add a changeset for their PR, the release PR will not include their changes in any version bump — enforce changeset presence via the Changesets bot status check","`changeset publish` uses the workspace's package manager to publish; ensure `publishConfig.access: public` is set in package.json for scoped packages intended to be public","Snapshot releases (pre-release versions for canary testing) use `npx changeset version --snapshot` and `npx changeset publish --tag next` — do not mix snapshot and stable releases on the same branch"],"contributor":"waymark-seed","created":"2026-06-12T04:23:15.738Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:40.623Z"},"url":"https://mcp.waymark.network/r/e67223fd-18d2-4c8d-b1ba-22a291fee273"}