From 67c17869b87ce9e4537d58acbe2599517ff08996 Mon Sep 17 00:00:00 2001
From: Bill <bill@bballou.com>
Date: Sun, 26 Oct 2025 11:56:11 -0400
Subject: [PATCH] docs: add GitHub release workflow documentation

---
 CLAUDE.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index b42c835..4a14cc0 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -234,6 +234,34 @@ This plugin is **desktop-only** (`isDesktopOnly: true`) because it uses Node.js
 - Create GitHub releases with tags that **exactly match** `manifest.json` version (no `v` prefix)
 - Attach required assets to releases: `manifest.json`, `main.js`, `styles.css`
 
+#### GitHub Release Workflow
+
+A GitHub Actions workflow automatically handles releases:
+
+**Location**: `.github/workflows/release.yml`
+
+**Trigger**: Push of semantic version tags (e.g., `1.2.3`)
+
+**Process**:
+1. Validates version consistency across `package.json`, `manifest.json`, and git tag
+2. Runs full test suite (blocks release if tests fail)
+3. Builds plugin with production config
+4. Creates draft GitHub release with `main.js`, `manifest.json`, and `styles.css`
+
+**Developer workflow**:
+```bash
+npm version patch  # or minor/major - updates manifest.json via version-bump.mjs
+git commit -m "chore: bump version to X.Y.Z"
+git tag X.Y.Z
+git push && git push --tags  # Triggers workflow
+```
+
+After workflow completes:
+1. Go to GitHub Releases
+2. Review draft release and attached files
+3. Write release notes
+4. Publish release
+
 ### Build Artifacts
 
 - **Never commit build artifacts** to version control (`main.js`, `node_modules/`, etc.)