| name | quickrelease |
| description | Cuts a MooshieUI semver release quickly, skipping bot reviews, pre-commit-checks, and local build validation. Bumps versions, prepends release notes, commits, pushes, creates/merges release PR, and tags the release. Use when the user says /quickrelease or wants a checkless release. |
Quick Release (MooshieUI)
Fast-path release: checkout main → version bump → changelog → push branch → PR → auto-merge → tag → CI.
This workflow skips all developer hygiene checks, linting, pre-commit hooks, and local build verification. Use it only when the changes are trivial and already verified.
Inputs
| Field | Default if omitted |
|---|
Version X.Y.Z | Read package.json, patch+1 (no v prefix in files) |
| Summary | git log since last v* tag |
Windows git (required)
git -c core.hooksPath=/dev/null ...
Pre-commit hook hangs in PowerShell without this.
Workflow
1. Sync main branch
Ensure you are on a fresh, updated main branch before bumping versions:
git checkout main
git pull origin main
2. Version bump (all three must match)
Update version in:
| File | Field |
|---|
package.json | "version": "X.Y.Z" |
src-tauri/Cargo.toml | version = "X.Y.Z" under [package] |
src-tauri/tauri.conf.json | "version": "X.Y.Z" |
3. Changelog files
Prepend to both RELEASE_NOTES.md and CHANGELOG.md:
## What's New in vX.Y.Z
### Fixes and maintenance
- Detail
---
## What's New in vPREVIOUS
CHANGELOG.md: new section goes directly under # Changelog.
4. Create and push release branch
git checkout -b release/vX.Y.Z
git add -A
git -c core.hooksPath=/dev/null commit -m "vX.Y.Z: Quick release"
git -c core.hooksPath=/dev/null push -u origin release/vX.Y.Z
5. Create Pull Request
gh pr create --base main --head release/vX.Y.Z --title "vX.Y.Z: Quick release" --body "<bullet list of changes>"
6. Merge PR
If branch checks are green or can be bypassed:
gh pr merge <PR_NUMBER> --squash --delete-branch
If branch policy blocks the merge due to pending checks or admin settings, add the --admin flag:
gh pr merge <PR_NUMBER> --squash --delete-branch --admin
7. Sync main & Tag
git checkout main
git fetch origin main
git reset --hard origin/main
git tag vX.Y.Z
git -c core.hooksPath=/dev/null push origin vX.Y.Z
This triggers the Build & Release workflow on GitHub Actions.
8. Cleanup
git fetch --prune origin
Prune any stale local branches.
9. Wiki pass [user-facing changes only]
Quick releases are usually trivial fixes that need no docs — skip this step then. But if this release adds, renames, or removes a user-facing feature or setting, sync the wiki (a separate repo: https://github.com/Mooshieblob1/MooshieUI.wiki.git, branch master, top-level *.md, nav _Sidebar.md).
git clone https://github.com/Mooshieblob1/MooshieUI.wiki.git <scratch>/MooshieUI.wiki # outside the main repo
Edit the page(s) for each user-facing item in this release's ## What's New in vX.Y.Z block, verifying exact UI labels against current code (src/lib/locales/en.ts + the component) — labels get renamed before ship. Match the wiki's concise, present-tense voice. Then:
git -c core.hooksPath=/dev/null commit -am "Document vX.Y.Z: <short summary>"
git -c core.hooksPath=/dev/null push origin master
No Co-Authored-By, no em dashes. Report pages touched (or that the wiki pass was skipped as internal-only).
Checklist
- [ ] Stale release/* branches cleaned up
- [ ] Three version files match X.Y.Z
- [ ] RELEASE_NOTES.md + CHANGELOG.md updated
- [ ] Release PR merged to main
- [ ] Tag vX.Y.Z pushed
- [ ] Release workflow running on GitHub
- [ ] Wiki pass done for user-facing changes (or skipped as internal-only)
Mistakes to avoid
- Adding
Co-Authored-By trailers to commits, PR bodies, or comments — never attribute AI assistance in any git or GitHub output
- Missing one of the three version files
git without core.hooksPath=/dev/null on Windows
- Tag before PR merge
- Force-updating tags — use
workflow_dispatch instead