What problem does it solve?
Convex validates every existing document against a new schema and fails the push if any row does not conform, so pushing an untested schema change directly to production risks a failed deploy or broken data. This Skill turns a preview deployment into a rehearsal copy seeded with a production snapshot, letting the conformance gate fail safely on the copy before the proven change is promoted to prod.
Core Features & Use Cases
- Snapshot-seeded rehearsal: Export production data with
npx convex export, create a preview deployment from pre-change code, and import the snapshot so the schema gate fails on the copy instead of prod.
- Ordered migration workflow: Follow the optional-field-first pattern, run batched backfills via @convex-dev/migrations, then tighten validators, verifying each push on the preview.
- Guarded promotion with rollback: Promote only after explicit confirmation, repeating the proven sequence on prod while keeping the snapshot as a rollback artifact.
- Use Case: When adding a required field to a live Convex table, rehearse the schema change and backfill on a preview deployment seeded with real data, verify the app functions against migrated rows, then promote to production with a known-good run.
Quick Start
Ask the agent to rehearse my Convex schema change and backfill on a preview deployment seeded with a production snapshot before promoting it to prod.
