mbc-debug

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

29|5|Updated Dec 21, 2023
One-click install
npx skills add https://github.com/mbc-net/mbc-cqrs-serverless --skill mbc-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mbc-debug
Source: https://github.com/mbc-net/mbc-cqrs-serverless/tree/main/packages/mcp-server/skills/mbc-debug
Command: npx skills add https://github.com/mbc-net/mbc-cqrs-serverless --skill mbc-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you diagnose and resolve errors when building or operating MBC CQRS Serverless applications on AWS, such as command failures, DynamoDB/version conflicts, missing data sync, tenant isolation issues, and import/task processing problems.

Core Features & Use Cases

  • Error-to-fix guidance: Quick lookup for common MBC error codes like command validation (pk/sk, type, version), DynamoDB/IAM issues, and tenantCode problems.
  • Targeted debugging workflows: Step-by-step approaches for command publishing issues, ConditionalCheckFailedException (optimistic locking), DataSyncHandler not triggering, and tenant isolation failures.
  • Practical runtime troubleshooting: Addresses frequent pitfalls including publishSync returning null on no-op (v1.2.0+), CSV batch import blocking (pre-v1.2.2), TaskModule dependency resolution (v1.2.4+), and RYW session TTL purge behavior (v1.2.6+).

Quick Start

Use the mbc-debug skill when you hit a runtime or startup error in your MBC CQRS Serverless project and need an immediate diagnostic checklist and likely fix.

Frequently Asked Questions about mbc-debug

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

FAQPage Schema
How do I troubleshoot DynamoDB ConditionalCheckFailedException in CQRS serverless applications?

To troubleshoot DynamoDB ConditionalCheckFailedException in CQRS serverless applications, follow targeted debugging workflows for optimistic locking conflicts, verifying command versioning and pk/sk validation to identify and resolve data synchronization failures.

Why does publishSync return null when publishing commands in MBC CQRS?

publishSync returns null as a known no-op behavior in MBC CQRS versions 1.2.0 and later, indicating the command was ignored rather than failing, requiring version-aware debugging workflows to verify.

How do I fix DataSyncHandler not triggering in AWS serverless CQRS pipelines?

To fix DataSyncHandler not triggering in AWS serverless CQRS pipelines, apply structured error lookup workflows to inspect command publishing errors, DynamoDB synchronization gaps, and tenant isolation failures blocking event processing.

What is the best way to debug tenant isolation failures in serverless applications?

The best way to debug tenant isolation failures in serverless applications is using structured diagnostic checklists to trace tenantCode validation errors and command routing issues across CQRS pipelines during local development or AWS deployments.

How do I resolve CSV batch import blocking in MBC CQRS serverless applications?

To resolve CSV batch import blocking in MBC CQRS serverless applications, upgrade to version 1.2.2 or later where the known fix is applied, then use runtime troubleshooting workflows to verify task pipeline processing.

What causes TaskModule dependency resolution errors in CQRS serverless applications?

TaskModule dependency resolution errors in CQRS serverless applications are a known issue fixed in MBC CQRS version 1.2.4 and later, requiring version-aware troubleshooting workflows to diagnose startup crashes and missing task registrations.