What problem does it solve? Convex rejects deployments when a schema does not match existing data at rest, so breaking changes like adding required fields, changing field types, or splitting tables cannot ship directly. This Skill guides the multi-deploy widen-migrate-narrow workflow so schema and data stay consistent throughout the migration. ## Core Features & Use Cases - Multi-Deploy Migration Planning: Structures breaking changes into widen schema, backfill data, then narrow schema phases with code that handles both old and new formats. - Batched Data Migrations: Uses the @convex-dev/migrations component for cursor-based pagination, dry runs, resume from failure, and status monitoring. - Use Case: You need to change a boolean isPro field into a plan enum on a teams table with production data. The Skill walks you through adding the optional new field, dual-writing during the window, running a dry-run-tested backfill migration, verifying completion, and deploying the narrowed schema. ## Quick Start Ask the assistant to plan a safe migration for adding a required role field to your existing Convex users table, including the schema changes, backfill migration, and verification steps.
