Agent Note Release Workflow
Use this skill when the task asks to release Agent Note, bump a version, cut a tag, publish npm packages, or verify a release.
Prepare
- Confirm the target version from the user request, accepting either
x.y.zorvx.y.z. Usex.y.zfor package metadata andvx.y.zfor the git tag. - Switch to
mainand pull the latest changes before an actual release. - Check the working tree. Do not release with unrelated dirty files.
- If the user only wants a rehearsal or passes
--dry-run, do not edit files, commit, tag, or push; only inspect state, run safe checks when useful, and preview the release notes.
Release
Follow these steps instead of relying on a release script:
- Update
packages/cli/package.jsontox.y.z. - Run
npm installfrom the repository root so npm updatespackage-lock.jsonand synchronizespackages["packages/cli"].versiontox.y.z. - Run
npm -w packages/cli run build. - Run
npm -w packages/cli run typecheck. - Run
npm -w packages/cli run lint. - Run
npm -w packages/cli test. - Preview release notes with
git-cliff --config .github/cliff.toml --unreleased --tag vx.y.z --strip header. - Stage
packages/cli/package.json,package-lock.json, and the rebuiltpackages/cli/dist/cli.js. - Commit only those release files as
chore: bump version to x.y.zwithRelease note: skip. - Create the annotated tag with
git tag -a vx.y.z -m vx.y.z. - Push
mainandvx.y.zonly when ready to publish.
Guardrails
- Do not manually push a release tag before the package version bump commit is on
main. - If release notes look like an implementation log, fix commit subjects or
Release note:bodies before tagging. - If any step fails after a local commit or tag, inspect the repository state before retrying; do not create duplicate tags.
- Keep release plumbing commits hidden with
Release note: skip.
Verify
After pushing a release tag:
- Watch the release workflow until completion.
- Verify the GitHub Release exists for
v<version>. - Verify npm publishes both
agent-note@<version>and@wasabeef/agentnote@<version>. - If release notes need copy edits after publication, update the GitHub Release body directly and keep the source commit guidance for future releases.
Report
End with:
- Version released or prepared
- Commands run
- Workflow status
- GitHub Release URL
- npm package versions confirmed