# Convex Migrate Rehearse

> Rehearse a live-app schema change + backfill on a snapshot-seeded preview deployment, verify, then promote the proven change to prod with the snapshot as rollback.

Source: https://skillsagentes.com/skills/get-convex/agent-skills/convex-migrate-rehearse
Repository: https://github.com/get-convex/agent-skills
Author: get-convex
License: not specified
Updated: hace 13 días
Context cost: 41 tok installed, 1.2k tok once triggered, 1.2k tok with every bundled file
Bundle: 1 file, 5 KB
Permissions requested: none declared

## Install

```bash
npx -y skills add get-convex/agent-skills --skill convex-migrate-rehearse --agent claude-code
```

## What it does

- Seeds a Convex preview deployment with a prod data snapshot to rehearse a schema change and backfill before touching prod
- Runs the optional-field → push → backfill → tighten sequence on the preview copy so the conformance gate fails safely there, not on prod
- Verifies migrated data and behavior on the preview, then repeats the proven sequence against prod on explicit confirmation
- Keeps the prod snapshot as a rollback artifact and enforces cleanup of the sensitive local snapshot file

## Use it when

- Changing a live app's schema plus running a backfill and wanting to rehearse the change safely first
- You have a Preview Deploy Key (or are willing to fall back to personal dev deployment) and need to validate a migration against real data shape

## Don't bother when

- You just want an explanation of the optional-then-tighten pattern with no live data involved — that's migrate

## What triggers it

- "Quiero probar este cambio de schema en un preview antes de aplicarlo en prod"
- "Necesito ensayar esta migración con backfill usando una copia de los datos reales"
- "Ayúdame a validar este cambio de esquema contra los datos de producción sin arriesgar prod"

## Before you install

- Requires a Preview Deploy Key exported as CONVEX_DEPLOY_KEY for preview deployments (paid-tier feature); otherwise falls back to rehearsing on the personal dev deployment.

## Files

- SKILL.md — 5 KB

## SKILL.md

Not reproduced here. Read it at https://github.com/get-convex/agent-skills/blob/main/skills/convex-migrate-rehearse/SKILL.md

---

Skills Agentes — https://skillsagentes.com/skills/get-convex/agent-skills/convex-migrate-rehearse