skills.rest
mbc-net
mbc-netOFFICIAL
Explore all skills by this author →
WebsiteGitHub

mbc-migrate

Guide MBC CQRS Serverless projects through framework version upgrades with migration checks.

29|5|Updated Dec 21, 2023
Search Tags:#serverless#dynamodb#cqrs#migration guide#step functions#mbc#publishasync
One-click install
npx skills add https://github.com/mbc-net/mbc-cqrs-serverless --skill mbc-migrate
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mbc-migrate
Source: https://github.com/mbc-net/mbc-cqrs-serverless/tree/main/packages/mcp-server/skills/mbc-migrate
Command: npx skills add https://github.com/mbc-net/mbc-cqrs-serverless --skill mbc-migrate

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about mbc-migrate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely upgrade my CQRS serverless framework version without breaking DynamoDB workflows?▼

To safely upgrade your CQRS serverless framework version, follow a structured migration matrix that documents breaking changes and required code adaptations. This prevents runtime workflow failures and data consistency issues across DynamoDB and Step Functions during dependency bumps.

What are common breaking changes when migrating CQRS serverless publish methods?▼

Common breaking changes when migrating CQRS serverless publish methods include deprecated APIs like .publish and publishPartialUpdate. Using pattern-based checks helps locate these deprecated usages, and troubleshooting snippets resolve handler decorator type mismatches and stuck import jobs.

Can I use a migration matrix to diagnose behavioral regressions in Step Functions after a serverless upgrade?▼

Yes, a version-to-version migration matrix helps diagnose behavioral regressions in Step Functions after a serverless upgrade. It highlights import flow differences, multi-tenancy key changes, and RYW-related behavioral updates that commonly cause runtime issues.

Why does my serverless CQRS upgrade break data consistency with RYW options?▼

Your serverless CQRS upgrade breaks data consistency with RYW options because newer framework versions introduce subtle behavioral differences in read-your-writes configurations. The migration guide identifies these RYW-related updates and provides targeted guidance to adapt your DynamoDB query patterns.

Do I need to update my migration skill before upgrading CQRS serverless core dependencies?▼

Yes, you should update your migration skill before upgrading CQRS serverless core dependencies. Pre-flight checks detect whether newer skill versions are available and guide whether to update first, ensuring you receive accurate deprecated API usage checks and current migration guidance.

Related Skills

Explore More Software Engineering Skills→
mbc-netmbc-net
29

mbc-debug

Diagnose MBC CQRS Serverless application failures with structured error lookup and targeted debugging workflows.

Official
Intermediate
juanjaragavijuanjaragavi

codebase-exploration

Locate functionality implementations and trace data flow across codebases.

Community
Advanced
david-2814david-2814
3

sam

Automate serverless application workflows with AWS SAM CLI.

Community
Advanced
secondskysecondsky
204

dependency-upgrade

Analyze dependency compatibility and plan staged major upgrades.

Community
Advanced