メニュー
Step-by-step release process for The Boosters legacy app (v0.x.y tags → mac + windows installers). Load before bumping version or pushing a release tag.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | boostnote-release |
| description | Step-by-step release process for The Boosters legacy app (v0.x.y tags → mac + windows installers). Load before bumping version or pushing a release tag. |
main and pushedgit status --short is empty (no uncommitted changes)Run the full pre-release gate:
npm run pre-release
This sequence must fully pass:
If any step fails → fix it and re-run before continuing.
Also verify CI is green on main:
gh run list --branch main --limit 3
| Change type | Increment | Example |
|---|---|---|
| Bug fix, security patch, no new features | patch | 0.16.10 → 0.16.11 |
| New user-visible feature, no breaking changes | minor | 0.16.x → 0.17.0 |
| Breaking change (e.g. Electron major bump, storage format change) | major | reserved |
Edit package.json "version" field:
# Example: bump to 0.16.12
# Edit package.json: "version": "0.16.12"
git add package.json
git commit -m "$(cat <<'EOF'
chore(release): v0.X.Y
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
EOF
)"
git tag v0.X.Y
git push origin main --tags
Tag format: v0.X.Y (matches release-legacy.yml trigger v*, excludes app-v*).
Two workflows trigger on the tag push:
gh run list --limit 5
| Workflow | File | Runtime | What it does |
|---|---|---|---|
| CI | ci.yml | ~3 min | ESM/CJS + lint + tests + build assertion |
| Release | release-legacy.yml | ~12–15 min | mac universal dmg/zip + windows nsis → GitHub Release |
Wait for both to show completed success.
gh release view v0.X.Y
Expected asset list:
The.Boosters-0.X.Y-mac.zip (universal mac, for quarantine-bypass)The.Boosters-0.X.Y.dmg (mac installer, arm64 + x64 universal)The-Boosters-Setup-0.X.Y.exe (windows nsis installer)latest-mac.yml, latest.yml (electron-updater manifests)If assets are missing: check the Release workflow logs.
gh run view <run-id> --log-failed
The Windows smoke test installs the real NSIS installer and asserts the main UI renders. Trigger manually:
gh workflow run win-smoke.yml -f tag=v0.X.Y
gh run watch
This takes ~10 min. Required if any of these changed:
browser/ JS or Stylus filesvite.renderer.config.mjslib/, index.js)gh release edit v0.X.Y --notes "$(cat <<'EOF'
## What's new
- <user-facing description>
## Install
**macOS**: Download `The.Boosters-0.X.Y.dmg`. First launch: right-click → Open (unsigned build).
**Windows**: Download `The-Boosters-Setup-0.X.Y.exe`. SmartScreen → More info → Run anyway.
EOF
)"
| Version | Key change |
|---|---|
| 0.16.11 | ESM/CJS mismatch fix (setLanguage crash) + CI detection script |
| 0.16.10 | First successful Mac+Windows Vite release (5 Windows path fixes) |
| 0.16.9 | Vite renderer replace webpack; AI inline writing assist |
Architecture, decisions, and working rules for modernizing Boostnote into a modern, collaborative, extensible note app. Load this before working on the modernization (stack choices, the collab core, the dependency overhaul, deploy/ops, or the new-app shell). Benchmarks: Obsidian, HackMD.
Feature development workflow for The Boosters legacy app. Load before implementing any new capability. Covers legacy constraints, file placement rules, ESM/CJS discipline, and pre-commit checklist.
Bug fix workflow for The Boosters legacy app. Load before diagnosing any runtime crash, CI failure, or UI regression. Contains symptom-by-symptom diagnosis checklist, known failure patterns, and commit protocol.