release

---

name: release description: Guide a two-phase release workflow using git worktrees: run scripts on main, then commit changes on release/ via PR.

What I do

• Provide a safe, two-phase release workflow compatible with this repo's release scripts.
• Phase A: prepare release artifacts on a worktree based on main (required by scripts).
• Phase B: move the resulting changes onto release/<version>, commit, and open a PR.
• Never merges automatically; reviewers decide.

Naming

• Base branch: origin/main
• Branch (phase B): release/<version>
• Version format: prefer X.Y.Z (semver) for stable release prep.
• Worktree path: ../.worktrees/pluto/<branch_sanitized> where / -> __.

Phase A (run scripts on main)

1. Ensure you are on a worktree whose branch is main.
2. Run the appropriate script (per repo docs), e.g. scripts/release.sh ....
3. Do not commit directly on main. Leave changes uncommitted.

Phase B (PR changes via release/)

1. Create branch release/<version> from origin/main.
2. Create a dedicated worktree for it.
3. Bring the uncommitted changes from Phase A into this worktree (e.g., by stashing/applying or by repeating deterministic script steps inside the release worktree).
4. Commit with Conventional Commits, then open PR to main.

Notes

• This repo uses squash-and-merge; PR title becomes the squashed commit on main.
• For changelog/semantic-release, PR title should follow Conventional Commits.