AGENTS.md · git:20261119.fe356ed · 2026-11-19 · sha256 fcf416a67ab06903
AGENTS.md git:20261119.fe356edA
Immutable. This exact content never changes and is served at /api/v1/blob/fcf416a67ab06903.
# Notes for coding agents ## Releasing Every release gets a CHANGELOG.md entry written from the commit history; the Publish to npm workflow refuses a tag without one and uses the entry as the GitHub release notes. 1. Raise the version everywhere it is kept (the `@open-artifact/*` packages, `plugins/dsh`, every plugin manifest and the marketplaces share one version). 2. Run `node scripts/changelog.mjs` to list the commits since the last `v*` tag (`node scripts/changelog.mjs <from> <to>` for another range). 3. Add a `## [x.y.z] - YYYY-MM-DD` section at the top of CHANGELOG.md: a one-line summary, then `### Added`, `### Changed`, `### Fixed` (and `### Removed` when something goes). Write what changed for people using Open Artifact, merging related commits; leave out release-bookkeeping commits and purely internal refactors. Add the version's compare link at the bottom (`[x.y.z]: https://github.com/JimLiu/open-artifact/compare/v<prev>...vx.y.z`). 4. Check it with `node scripts/changelog.mjs --check x.y.z`, commit, tag `vx.y.z` and push the tag.