docs: update versioning docs to reflect changesets workflow

brunozoric · claude · brunozoric · commit 845aec61a1ad · 2026-05-20T15:08:21.000+02:00
README and AGENTS.md still described the old conventional-commit
publish pipeline. Updated to document the Changesets workflow and
removed the hardcoded version from the AGENTS.md package.json example.

Co-Authored-By: Claude Opus 4.6 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/AGENTS.md b/AGENTS.md
@@ -918,7 +918,7 @@ import { createAbstraction } from "~/common/index.js";
 ```json
 {
   "name": "@webiny/stdlib",
-  "version": "0.0.1",
+  "version": "<managed by changesets>",
   "type": "module",
   "exports": {
     ".": { "import": "./dist/index.js", "types": "./dist/index.d.ts" },
diff --git a/README.md b/README.md
@@ -57,4 +57,4 @@ The package is ESM-only and ships three subpath exports. Because each is a separ
 
 ## Versioning
 
-The package version in `package.json` is always `0.0.0`. The real version is injected at publish time by the release pipeline using conventional commits: `feat` bumps the minor, everything else (`fix`, `chore`, `refactor`, …) bumps the patch. There are no major version bumps — breaking changes may land on minor releases.
+Versioning and publishing are managed by [Changesets](https://github.com/changesets/changesets). The version in `package.json` is the real published version, bumped automatically when a version PR is merged. To record a version bump, run `yarn changeset` before opening a PR. There are no major version bumps — breaking changes may land on minor releases.

Original file line number	Diff line number	Diff line change
`@@ -918,7 +918,7 @@ import { createAbstraction } from "~/common/index.js";`
`918`	`918`	```json
`919`	`919`	`{`
`920`	`920`	`"name": "@webiny/stdlib",`
`921`		`- "version": "0.0.1",`
	`921`	`+ "version": "<managed by changesets>",`
`922`	`922`	`"type": "module",`
`923`	`923`	`"exports": {`
`924`	`924`	`".": { "import": "./dist/index.js", "types": "./dist/index.d.ts" },`
Original file line number	Diff line number	Diff line change
`@@ -57,4 +57,4 @@ The package is ESM-only and ships three subpath exports. Because each is a separ`
`57`	`57`
`58`	`58`	`## Versioning`
`59`	`59`
`60`		-The package version in `package.json` is always `0.0.0`. The real version is injected at publish time by the release pipeline using conventional commits: `feat` bumps the minor, everything else (`fix`, `chore`, `refactor`, …) bumps the patch. There are no major version bumps — breaking changes may land on minor releases.
	`60`	+Versioning and publishing are managed by [Changesets](https://github.com/changesets/changesets). The version in `package.json` is the real published version, bumped automatically when a version PR is merged. To record a version bump, run `yarn changeset` before opening a PR. There are no major version bumps — breaking changes may land on minor releases.