What problem does it solve?
After squash-merge releases, history divergence between main and dev creates conflicts for subsequent PRs. This skill automates reconciliation by creating a framework-guided merge PR that makes the release squash commit an ancestor of dev, preserving history and simplifying future release flows.
Core Features & Use Cases
- Pre-flight checks to verify repository identity, tag presence, and required branches.
- Creates a sync branch from upstream/dev, merges upstream/main with -X ours to preserve dev content, and opens a merge PR against dev.
- Carries forward CHANGELOG.md from main when needed as a separate commit to maintain release notes history.
- Idempotent: detects already-synced repos and performs no-op, ensuring safe re-runs.
- Enforces safety and governance: framework-only, true merge PR flow, audit-friendly commits.
Quick Start
Invoke the release-sync operation with a version tag to create the sync PR that reconciles main into dev after the release.