| name | release-prepare |
| description | Prepare a release in this repository by bumping the app version, updating release notes, creating a release branch named release/<version>, and preparing the PR for merge before any release builds or tags are created. |
| allowed-tools | Bash Read Grep Glob Edit Write |
| model | claude-sonnet-4-6 |
Flutter Template Release Prepare
Use this skill when preparing a release branch and PR in this repository.
Read First
AGENTS.mddocs/PROJECT_GUIDELINES.mdREADME.mdpubspec.yamlrelease_notes.txt
Goal
This skill is for the pre-build release phase.
It should:
- update the app version
- update
release_notes.txt
- create or prepare a branch named
release/<version>
- prepare the release PR
It should not:
- create Android release tags yet
- build Android release artifacts yet
- build iOS IPA files yet
Release builds happen only after the release PR is merged.
Workflow
- Confirm the target release version.
- Update
pubspec.yaml to that version.
- Add a matching release-notes section to
release_notes.txt.
- Verify that the release branch should be named
release/<version>.
- Create or switch to
release/<version>.
- Run:
make gen if required by any included changesfvm flutter analyzefvm flutter test
- Prepare the PR targeting the team’s release base branch.
- Only after the PR is merged should release builds or release tags be created.
Watch Outs
- Do not create Android tags during the prepare phase.
- Do not build iOS IPA files during the prepare phase.
- Keep release notes consistent with the actual shipped changes.
- If the branch target differs from the repo defaults documented in
README.md, follow the actual team process.
Completion Criteria
- version updated
- release notes updated
- branch named
release/<version>
- PR is ready for review or merge
- no build or tag steps were mixed into this phase
