release-orchestration

name	release-orchestration
description	Activate this skill whenever preparing a release, bumping versions, or creating tags.

Release Orchestration

Release & Version Automation

• Automated Orchestrator: AI agents MUST never manually bump version strings, modify metadata config files (e.g. pyproject.toml, constants.py), or create/push git tags. You MUST always use the automated orchestrator script:

  • To bump versions and tag pre-releases:

    python3 scripts/release.py --bump beta
    

  • To promote pre-releases to stable releases (must be run from the active release branch):

    python3 scripts/release.py --promote
    

Pre-Release Strategy

To prevent "version fatigue" and ensure the stability of the main release channel:

• Release Orchestration: All version updates, pre-releases, and stable promotions MUST be performed using the automated orchestrator script. Manual git tagging or direct version modifications are strictly prohibited.
• Experimental Features: All brand new or complex functionality (specifically Liferay Cloud Golden Path integrations) MUST be released as Pre-Releases (e.g. v2.10.x-pre.y) first.
• Verification Gate: A pre-release feature is only eligible for a stable release after the user has explicitly confirmed they have performed a full manual E2E verification of the pre-release. Do not automatically promote releases without explicit user confirmation.
• Immutable Tags (The Burn Rule): GitHub Repository Rules strictly prohibit the deletion or force-updating of Git tags. Once a tag (e.g. v2.15.19) is pushed, it is permanently locked to that commit. Any premature tagging permanently burns the version number, requiring a version bump to recover. You MUST be absolutely certain all pre-requisites are met before tagging.
• Compatibility Matrix Gate: You MUST update the compatibility matrix (in the project documentation) to reflect the newly verified environments BEFORE moving to a stable release.
• Stable Promotion: Stable releases ([release]) MUST be reserved for hardened features and verified bugfixes.