convex-migrate-rehearse
Rehearse a live-app schema change + backfill on a snapshot-seeded preview
by get-convexFree
Description
convex-migrate-rehearse is an agent skill that rehearses a schema change and its data backfill on a preview deployment before the change is made to production. A Convex schema push checks every existing document against the new schema and fails the push if any row does not conform, which is a useful gate. The safe way to use that gate is to let it fail on a rehearsal copy rather than on production. The skill turns a preview deployment into that copy by seeding it with a production snapshot, pushing the new schema, running the backfill, and watching the gate. Only when the rehearsal is green does it promote the change to production, using the snapshot as a safety net. It combines the deploy guard, which classifies the target, the optional-then-required migration pattern, and the @convex-dev/migrations package for a batched and resumable backfill. Preview deployments need a Preview Deploy Key, which the skill explains how to obtain from the dashboard, and the feature is available on paid plans. If no preview key is available, the skill falls back to rehearsing on your personal development deployment and says so. It is part of the get-convex agent-skills repository and is added to a compatible agent with the skills command.…
Highlights
- Rehearses schema changes on a preview copy
- Seeds the preview from a production snapshot
- Promotes only after the rehearsal passes
- Falls back to a dev deployment if needed
Ratings & Reviews
No ratings yet
Be the first to rate convex-migrate-rehearse.
People also visit
convex-authz
Audit and harden a Convex app's authorization: identity-from-arg impersonation
convex-migrate-rehearse FAQ
What does convex-migrate-rehearse do?
It tests a schema change and backfill on a preview deployment seeded from a production snapshot, and promotes it to production only if it passes.
Why rehearse first?
A schema push fails if existing rows do not match the new schema, and the skill lets that failure happen on the rehearsal copy.
What do I need for previews?
A Preview Deploy Key exported as CONVEX_DEPLOY_KEY. The skill says preview creation is a paid-tier feature.
What if I have no preview key?
It falls back to rehearsing on your personal development deployment seeded with the snapshot, and tells you it has done so.
How do I install it?
Run: npx skills add https://github.com/get-convex/agent-skills --skill convex-migrate-rehearse
What are the best convex-migrate-rehearse alternatives?
Popular alternatives to convex-migrate-rehearse include convex-migrate, convex-auth and convex-expert. See all convex-migrate-rehearse alternatives