mbc-migrate

What problem does it solve?

MBC CQRS Serverless version upgrades can introduce breaking changes and subtle behavioral differences that break compilation, runtime workflows, or data consistency. This skill provides a structured migration path so you can upgrade framework versions with confidence.

Core Features & Use Cases

• Upgrade pre-flight checks: Detects whether newer skill versions are available and guides whether to update before running migration guidance.
• Version-to-version migration matrix: Summarizes breaking changes and their key impacts across multiple MBC versions (from low to high complexity).
• Targeted guidance for common upgrade pain points: Covers major API changes (e.g., publish methods), multi-tenancy key changes, Step Functions import flow differences, and RYW-related behavioral updates.
• Automated migration checks (pattern-based): Recommends how to locate deprecated API usage (such as .publish and publishPartialUpdate) and highlights potential breaking usages in your codebase.
• Practical troubleshooting snippets: Includes common issue causes and example fixes (e.g., version field handling, handler decorator type mismatches, stuck import jobs).

Quick Start

Run the skill to generate a migration plan for upgrading your project from your current @mbc-cqrs-serverless/core version to the target version, then apply the flagged code and infrastructure changes.