From kagents
K.Actions.ReleaseFlow process — branching model (feature → dev → release → main), phases (Alpha, Freeze, Beta, Stable), guardrails G1–G5, release-train planning, feature-freeze enforcement, pre-release tagging, smart tags. USE FOR: understanding ReleaseFlow branching, planning releases, checking phase rules and guardrails. DO NOT USE FOR: changelog/tag creation (use release-management) or modifying ReleaseFlow code (use releaseflow-coding-patterns).
npx claudepluginhub grexyloco/k.agentsThis skill uses the workspace's default tool permissions.
K.Actions.ReleaseFlow ist eine GitHub Composite Action + PowerShell-Modul für automatisierte Release-Orchestrierung. Single Entry Point: `New-Release` erkennt die Phase automatisch aus dem Branch-Kontext.
Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.
Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).
Share bugs, ideas, or general feedback.
K.Actions.ReleaseFlow ist eine GitHub Composite Action + PowerShell-Modul für automatisierte Release-Orchestrierung. Single Entry Point: New-Release erkennt die Phase automatisch aus dem Branch-Kontext.
Abhängigkeit: K.PSGallery.Smartagr (Tagging-Backend, separates Modul auf PSGallery)
feature/* ──→ dev/vX.Y.Z ──→ release/vX.Y.Z ──→ main
fix/* ──→ dev/vX.Y.Z fix/* ──→ release/vX.Y.Z
│
Backflow PRs ──→ offene dev/* Branches
| Source Branch | Target Branch | Phase | Aktion |
|---|---|---|---|
feature/* | dev/vX.Y.Z | Alpha | Alpha-Tag + GitHub Release (prerelease) |
fix/* | dev/vX.Y.Z | Alpha | Alpha-Tag + GitHub Release (prerelease) |
dev/vX.Y.Z | release/vX.Y.Z | Freeze | Freeze-Tag + Promotion-PR |
fix/* | release/vX.Y.Z | Beta | Beta-Tag + GitHub Release (prerelease) |
release/vX.Y.Z | main | Stable | Draft veröffentlichen + Smart Tags + Backflow PRs |
| ID | Name | Prüft | Blockiert |
|---|---|---|---|
| G1 | Dev-Gate | Draft-Intent existiert für Zielversion | Merge ohne Release-Plan |
| G2 | Freeze-Gate | Release-Branch existiert → keine neuen Features | Feature-PRs nach Freeze |
| G3 | Beta-Gate | Nur fix/* Commits seit Freeze | Nicht-autorisierte Änderungen |
| G4 | Stable-Gate | CI grün, alle Betas erfolgreich | Broken Release |
| G5 | Feature-Freeze-Enforcement | Freeze-Tag aktiv → nur Bugfixes | Feature-PRs während Freeze |
Fail-Fast: Orchestrator bricht beim ersten fehlgeschlagenen Guardrail ab.
New-ReleaseTrain -TargetVersion "2.0.0" erstellt atomar:
v2.0.0dev/v2.0.0 vom letzten Stable-TagPO-Guardrails: PD-1 (Duplikat-Intent), PD-2 (Tag existiert), PD-3 (Branch existiert), PD-4 (Base existiert), PD-5 (Downgrade-Schutz)
| Tag-Typ | Format | Beispiel | Erstellt von |
|---|---|---|---|
| Alpha | vX.Y.Z-alphaN | v1.2.0-alpha3 | New-AlphaRelease |
| Beta | vX.Y.Z-betaN | v1.2.0-beta1 | New-BetaRelease |
| Freeze-Marker | vX.Y.Z-freeze | v1.2.0-freeze | New-FreezeRelease |
| Stable | vX.Y.Z | v1.2.0 | Publish-StableRelease |
| Smart (Major) | vX | v1 | K.PSGallery.Smartagr |
| Smart (Minor) | vX.Y | v1.2 | K.PSGallery.Smartagr |
| Latest | latest | latest | K.PSGallery.Smartagr |
Nur ein Release-Train darf gleichzeitig eingefroren sein.
Freeze-Lifecycle:
dev/vX.Y.Z → Tag vX.Y.Z-freeze gesetztfeature/*, G3 erlaubt nur fix/*Immer GitHub App Token (nie PATs):
k-releaseflow-bot[bot]on: push Workflows- uses: actions/create-github-app-token@v2
id: app-token
with:
app-id: ${{ vars.RELEASEFLOW_APP_ID }}
private-key: ${{ secrets.RELEASEFLOW_APP_PRIVATE_KEY }}
releaseflow.json wird auto-seededexamples/)New-ReleaseTrain für ersten Release-Train| Output | Beschreibung | Verfügbar bei |
|---|---|---|
tag | Erstellter Git-Tag | Alle Phasen |
version | SemVer ohne v-Prefix | Alle Phasen |
phase | alpha/beta/stable/freeze | Alle Phasen |
release-url | URL des GitHub Release | Alle Phasen |
is-prerelease | true bei alpha/beta | Alle Phasen |
backflow-prs | PR-URLs (komma-separiert) | Nur Stable |
error-message | Fehlermeldung bei Guardrail-Fehler | Bei Fehler |