From 7a50a9292ed246bbd695cf94baa6ad18678e9047 Mon Sep 17 00:00:00 2001
From: Shaw Innes <shaw@immortal.net.au>
Date: Fri, 6 Mar 2026 22:15:14 +1000
Subject: [PATCH 1/2] docs: add release skill

---
 .claude/skills/release/SKILL.md | 42 +++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 .claude/skills/release/SKILL.md

diff --git a/.claude/skills/release/SKILL.md b/.claude/skills/release/SKILL.md
new file mode 100644
index 0000000..61b039e
--- /dev/null
+++ b/.claude/skills/release/SKILL.md
@@ -0,0 +1,42 @@
+---
+name: release
+description: Use when releasing a new version of aitool-cli to production
+---
+
+# Release
+
+Releases are driven by git tags. Pushing a `v*` tag triggers the GitHub Actions release workflow, which builds all platform binaries and publishes a GitHub Release.
+
+## Process
+
+1. Ensure `main` is clean and all changes are committed and pushed.
+2. Bump the version and create a tag:
+
+```sh
+bun run release          # patch bump (1.4.1 → 1.4.2)
+bun run release:minor    # minor bump (1.4.1 → 1.5.0)
+bun run release:major    # major bump (1.4.1 → 2.0.0)
+```
+
+3. Push the commit and tag together:
+
+```sh
+git push origin main --tags
+```
+
+That's it. The CI release workflow handles the rest.
+
+## What `bun run release` does
+
+Runs `npm version patch --message 'chore: release v%s'`, which:
+- Bumps the version in `package.json`
+- Creates a commit with message `chore: release vX.Y.Z`
+- Creates an annotated git tag `vX.Y.Z`
+
+## Common mistakes
+
+| Mistake | Fix |
+| --- | --- |
+| `git push` without `--tags` | Tag never reaches remote; CI never fires. Always use `--tags`. |
+| Running release on a dirty tree | Commit or stash changes first. |
+| Pushing the tag before `main` | Push both together: `git push origin main --tags`. |

From 209fc61038540ddb157dc35f5d0d41f2de2ca96e Mon Sep 17 00:00:00 2001
From: Shaw Innes <shaw@immortal.net.au>
Date: Fri, 6 Mar 2026 22:26:56 +1000
Subject: [PATCH 2/2] fix: use PowerShell Move-Item instead of CMD move /Y in
 Windows update instructions

---
 src/update.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/update.ts b/src/update.ts
index cfe3c71..eb92480 100644
--- a/src/update.ts
+++ b/src/update.ts
@@ -156,7 +156,7 @@ export async function selfUpdate(): Promise<void> {
 		console.log(`\nDownloaded new binary to: ${dest}`);
 		console.log(
 			`To complete the update, replace the current binary:\n` +
-				`  move /Y "${dest}" "${process.execPath}"`,
+				`  Move-Item -Force "${dest}" "${process.execPath}"`,
 		);
 		return;
 	}