Release Flow
After verification passes, bump the version, update the changelog, tag the repo, and optionally create a GitHub release.
Steps
- Confirm verification passed — refuse to release without prior quality gate evidence
- Detect version source — package.json, pyproject.toml, VERSION file, or git tags
- Preflight — run the helper in verify mode to confirm git cleanliness, git identity, target tag availability, version source, changelog readiness, notes destinations, and optional
gh readiness before any mutation
- Plan the release — preview version bump level (patch, minor, major) and changelog entry
- Execute — bump version, update changelog, create annotated git tag
- GitHub release (optional) — validate
gh auth, then create release with notes
- Report — version, tag, changelog path, any skipped steps with reasons
Output
Version: <old> → <new>
Tag: v<new>
Changelog: updated | skipped (no [Unreleased] section)
Preflight: ready | blocked (reason)
GH Release: created | skipped (reason)
Rules
- Never release without prior verification evidence
- Never invent a version file or changelog format the repo doesn't use
- Never publish artifacts without confirmed auth
- Only update changelog when it already has an
[Unreleased] section
- Report skipped steps with reasons instead of failing silently
1---2name: release-flow3description: Ship validated changes with repeatable release evidence — version bump, changelog, tag, and optional GitHub release4---56# Release Flow78After verification passes, bump the version, update the changelog, tag the repo, and optionally create a GitHub release.910## Steps11121. **Confirm verification passed** — refuse to release without prior quality gate evidence132. **Detect version source** — package.json, pyproject.toml, VERSION file, or git tags143. **Preflight** — run the helper in verify mode to confirm git cleanliness, git identity, target tag availability, version source, changelog readiness, notes destinations, and optional `gh` readiness before any mutation154. **Plan the release** — preview version bump level (patch, minor, major) and changelog entry165. **Execute** — bump version, update changelog, create annotated git tag176. **GitHub release** (optional) — validate `gh` auth, then create release with notes187. **Report** — version, tag, changelog path, any skipped steps with reasons1920## Output2122```text23Version: <old> → <new>24Tag: v<new>25Changelog: updated | skipped (no [Unreleased] section)26Preflight: ready | blocked (reason)27GH Release: created | skipped (reason)28```2930## Rules3132- Never release without prior verification evidence33- Never invent a version file or changelog format the repo doesn't use34- Never publish artifacts without confirmed auth35- Only update changelog when it already has an `[Unreleased]` section36- Report skipped steps with reasons instead of failing silently
LucasSantana-Dev