diff --git a/.changeset/migrate-cli-commands-to-cleye.md b/.changeset/migrate-cli-commands-to-cleye.md
index b057acfe0b..9d52fb2260 100644
--- a/.changeset/migrate-cli-commands-to-cleye.md
+++ b/.changeset/migrate-cli-commands-to-cleye.md
@@ -1,5 +1,13 @@
 ---
-'@backstage/cli': patch
+'@backstage/cli': minor
 ---
 
-Migrated remaining CLI command handlers from `commander` to `cleye` for argument parsing. A few CLI flags that were previously camelCase have been normalized to kebab-case to match standard CLI conventions. Affected flags: `--baseVersion` → `--base-version`, `--successCache` → `--success-cache`, `--successCacheDir` → `--success-cache-dir`, `--alwaysPack` → `--always-pack`.
+**BREAKING**: Migrated remaining CLI command handlers from `commander` to `cleye` for argument parsing. The following CLI flags have been renamed from camelCase to kebab-case to match standard CLI conventions:
+
+- `--baseVersion` → `--base-version`
+- `--successCache` → `--success-cache`
+- `--successCacheDir` → `--success-cache-dir`
+- `--alwaysPack` → `--always-pack`
+- `--alwaysYarnPack` → `--always-pack` (hidden legacy alias preserved)
+
+If you have scripts or CI configurations that use any of the above flags, update them to the new kebab-case spelling.