release-management

Gate Flutter release APK commits behind local analysis, tests, and user confirmation.

18|3|Updated Dec 14, 2025
One-click install
npx skills add https://github.com/SaadhJawwadh/Note-taking --skill release-management-saadhjawwadh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-management
Source: https://github.com/SaadhJawwadh/Note-taking/tree/main/.agent/skills/release-management
Command: npx skills add https://github.com/SaadhJawwadh/Note-taking --skill release-management-saadhjawwadh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents broken public releases by enforcing a local build-and-test verification step and explicit user approval before any git lifecycle actions that can trigger CI/CD.

Core Features & Use Cases

  • Local Build & Testing Gate: Runs analysis and tests locally, then builds a release APK for the user to validate before any commit/tag/push.
  • Consent-First Git Operations: Requires explicit, real-time permission before committing changes, tagging a version, or pushing triggers for GitHub releases.
  • Release Hygiene & Safety Checks: Standardizes changelog updates and pubspec version bumping, and includes troubleshooting guidance for common release pitfalls (e.g., ProGuard, tag conflicts, and backup completeness for settings migrations).

Quick Start

Prepare the release by running flutter analyze and flutter test, then build the release APK and wait for confirmation that the APK behaves correctly before asking permission to commit and push the release tag.

Frequently Asked Questions about release-management

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent broken Flutter releases from triggering CI/CD pipelines?

Prevent broken Flutter releases by enforcing a local build-and-test verification gate that runs flutter analyze and flutter test, builds the release APK, and requires explicit user validation before any git commit, tag, or push triggers CI/CD.

What is the safest way to coordinate git tags with pubspec version updates?

The safest way to coordinate git tags with pubspec version updates is a consent-first workflow that standardizes changelog updates and pubspec version bumping, then gates the git lifecycle behind explicit user permission before pushing release tags.

How do I verify a release APK before pushing a git tag for a public version update?

Verify a release APK by building it locally after running flutter analyze and flutter test, then manually validating the artifact's stability and behavior before granting permission to finalize the git commit and push the release tag.

Can I require manual approval before git commit and push operations for a Flutter release?

Yes, you can require manual approval by using a consent-first workflow that applies permission-gated git actions, ensuring explicit real-time user confirmation is given before committing changes, tagging a version, or pushing triggers for GitHub releases.

What should I do if I encounter tag conflicts or ProGuard issues during a Flutter release?

Resolve tag conflicts or ProGuard issues during a Flutter release by following built-in troubleshooting guidance that addresses common release pitfalls, including tag conflicts, ProGuard configuration, and backup completeness for settings migrations.