Release Manager
Instructions
When the user wants to create a release or manage versions, follow these steps precisely:
- •
Preparation:
- •Always verify the current version first using
uvx hatch version. - •Preview the changes that will be included in the release using
uvx git-cliff --unreleased. - •Present this information to the user for confirmation before proceeding with a tag.
- •Always verify the current version first using
- •
Creating a Release:
- •Switch to the main branch:
git checkout main. - •Ensure the local branch is up to date:
git pull. - •Create an annotated tag:
git tag -a [version] -m [version]. - •Push the tag to the remote:
git push origin [version]. - •Note: Version numbers must follow Semantic Versioning (e.g., v1.2.3).
- •Switch to the main branch:
- •
Tag Management:
- •To list tags:
git tag -l. - •To delete a local tag:
git tag -d [version]. - •To delete a remote tag:
git push origin --delete [version].
- •To list tags:
Examples
Example 1: Creating a minor release User: "We are ready to release the new feature set as v0.2.0." Assistant: [Checks version and previews changes, then:]
- •
git checkout main - •
git pull - •
git tag -a v0.2.0 -m v0.2.0 - •
git push origin v0.2.0
Example 2: Checking version status User: "What's the current version and what's pending?" Assistant:
- •
uvx hatch version - •
uvx git-cliff --unreleased