Developer Bump Version Agent Skill

Bump Version — Start New Development Cycle on Main

Bump the Earth2Studio package version on main to the next minor alpha and

insert a blank CHANGELOG section. This is the minimal set of changes needed to

unblock further development commits on main after a release branch merge.

Follow every step below in order. Each confirmation gate requires explicit

user approval before proceeding.

Step 1 — Determine the Next Version and Create Branch

• Read earth2studio/__init__.py to get the current __version__ string.
• Compute the next minor alpha:
• If current is X.Y.0 (release), next is X.(Y+1).0a0.
• If current is X.Y.0rcN or X.Y.0aN, next is X.(Y+1).0a0.
• If the version already ends in a0 at the expected next minor, the bump

may already be done — note this and confirm with the user.

• Read CHANGELOG.md and check whether a section for the target version

already exists. If it does, the bump is already complete — inform the user

and stop.

[CONFIRM — Version]

Print the current version, the target version, and ask the user to confirm

before proceeding.

1b — Create or verify the bump branch

Check the current branch name:

git branch --show-current

If already on a branch named version-bump-X.(Y+1).0a0, skip branch creation.

Otherwise, create a new branch from main:

git checkout main
git pull upstream main
git checkout -b version-bump-X.(Y+1).0a0

(Replace X.(Y+1).0a0 with the actual computed target version.)

Step 2 — Update CHANGELOG.md

Read CHANGELOG.md and insert a new blank section above the most recent

version entry. Use xxxx-xx-xx as the date placeholder — never fill in today's

date for the new development version.

The new section must look exactly like this (substituting the version number):

## [X.(Y+1).0a0] - xxxx-xx-xx

### Added

### Changed

### Deprecated

### Removed

### Fixed

### Security

### Dependencies

Also ensure the released version section (the one just below):

• Has unused (empty) subsections removed.
• Does not have the alpha/rc extension in its version (e.g., [0.16.0]

not [0.16.0a0]).

• Has a release date set in YYYY-MM-DD format.

[CONFIRM — Release Date]

If the use doesn't know, just keep it as is, make sure to tell user this is an option.

If the released section does not already have a date set, ask the user what

date to use before proceeding.

Step 3 — Bump the Package Version

Run these two commands in sequence:

uv run hatch version minor
uv run hatch version alpha

After running, read earth2studio/__init__.py and confirm it now contains the

expected X.(Y+1).0a0 version string.

If a pre-commit hook (pyupgrade or similar) fails due to a Python version

incompatibility, it is safe to skip with SKIP=pyupgrade on the subsequent

commit step — note this to the user.

Step 4 — Commit and Push

Stage only the expected files and commit:

git add CHANGELOG.md earth2studio/__init__.py
git commit -m "Bump version to X.(Y+1).0a0"

Push the branch (or the current branch if already on a feature branch):

git push origin HEAD

[REMIND — PR or Direct Push]

After pushing, remind the user:

> If main is protected, open a PR titled "Bump version to X.(Y+1).0a0"

> targeting main. Otherwise the direct push is sufficient.