AGENT SKILL

convex-migrate

Migrate schema + backfill data on a deployed Convex app using @convex-dev/migrations.

License 许可
MIT
所属仓库
openclaw/clawhub
最近更新
2026-11-15
Stars
★ 9.6k
Forks
1.5k

01 前言 Front Matter

name
convex-migrate
description
Migrate schema + backfill data on a deployed Convex app using @convex-dev/migrations.

03 SKILL.md 正文

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

Migrate the schema / data on a live app

Change a deployed schema without breaking existing data: stage the schema change, install @convex-dev/migrations, write a backfill that makes old rows valid, run it, and verify before tightening the validator.

Workflow

  1. Make the new field optional first (so deploy doesn't reject existing rows).
  2. Install @convex-dev/migrations; write a migration that backfills/transforms existing rows.
  3. Run the migration; verify all rows are valid.
  4. Tighten the validator (make the field required) once the backfill is complete.

Rules

  • Never tighten a validator before the backfill completes — it rejects existing rows and breaks the live app.
  • Add new fields as optional first, migrate, then require.
  • Verify row counts before and after.

04 同仓库更多 Skills