# Convex Migrate Rehearse

Rehearse a live-app schema change + backfill on a snapshot-seeded preview deployment...

- Repository: https://github.com/openclaw/clawhub (9543 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add openclaw/clawhub --skill convex-migrate-rehearse -g -a claude-code -y`
Codex: `npx skills add openclaw/clawhub --skill convex-migrate-rehearse -g -a codex -y`
Cursor: `npx skills add openclaw/clawhub --skill convex-migrate-rehearse -g -a cursor -y`
Gemini CLI: `npx skills add openclaw/clawhub --skill convex-migrate-rehearse -g -a gemini-cli -y`

## Description

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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

<!-- GENERATED from convex-agents content/capabilities/migrate-rehearse.json, do not edit by hand. -->

# Rehearse a schema change on a preview before prod

A schema push on Convex validates every existing document against the new schema and FAILS the push if any row doesn't conform, a real data-conformance gate. The safe way to use that gate is to let it fail on a rehearsal copy, not on prod. This capability turns a preview deployment into that copy: seed it with a prod snapshot, push the new schema + run the backfill there, watch the gate, and only promote once it's green. It composes deploy-guard (target classification), migrate (the optional-then-tighten pattern), and @convex-dev/migrations (the batched, resumable backfill).

## Workflow

The rest: https://github.com/openclaw/clawhub/blob/HEAD/.agents/skills/convex-migrate-rehearse/SKILL.md