Git Release Workflow

Steps

1. Sync main

git checkout main && git pull

1. Read current version from

   package.json

   ,

   pyproject.toml

   ,

   Cargo.toml

   , or equivalent — whichever exists in the project
2. Generate release notes
   • Run

     git log --oneline <last-tag>..HEAD

     to get commits since last release
   • Group by type: Features, Bug Fixes, Refactors, Other
   • Format as markdown bullet list
   • Show the user the release notes before proceeding
3. Tag and push

git tag vX.Y.Z
git push origin main --tags

1. Create GitHub release

gh release create vX.Y.Z --title "vX.Y.Z" --notes "<release notes from step 3>"

Rules

• Always sync main first — never release from a feature branch
• Tag format:

  vX.Y.Z

  (with

  v

  prefix)
• Never skip the tag — GitHub release requires a tag
• Show the user the release notes before creating the release
• Wait for user confirmation before tagging