migration-helper

Plan and execute Convex schema migrations with backfills and dual-write strategies.

3|Updated May 23, 2026
One-click install
npx skills add https://github.com/waynesutton/finder9 --skill migration-helper-waynesutton
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migration-helper
Source: https://github.com/waynesutton/finder9/tree/main/.codex/skills/migration-helper
Command: npx skills add https://github.com/waynesutton/finder9 --skill migration-helper-waynesutton

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convex schema migrations can be risky and disruptive; this Skill provides a safe, structured approach to evolving schemas without downtime.

Core Features & Use Cases

  • Additive changes: safely introduce optional fields and new tables.
  • Backfill and validate data across existing records.
  • Zero-downtime strategies: use dual-write and staged migrations.

Quick Start

Add the new field as optional, backfill existing records, then enforce the field as required after migration.

Frequently Asked Questions about migration-helper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate a Convex schema without downtime?

To migrate a Convex schema without downtime, add new fields as optional, backfill existing records via batch processing, and then enforce the fields as required. This staged approach uses dual-write patterns to prevent data disruption.

What is the best way to backfill existing records during a Convex schema migration?

The best way to backfill records during a Convex schema migration is to use batch processing via internal mutations. This allows you to safely transform and validate data across existing records before enforcing new schema requirements.

How do I change an optional field to required in Convex?

To change an optional field to required in Convex, first add the field as optional, execute a backfill to populate the field across all existing records, and then update the schema to enforce it as required.

Does the zero-downtime Convex migration strategy support renaming existing data structures?

Yes, the zero-downtime Convex migration strategy supports renaming structures. It uses staged migrations and dual-write patterns to ensure data consistency while safely transforming existing schema definitions without disrupting production.

Can I execute Convex data transformations directly from the dashboard?

Yes, you can execute Convex data transformations directly from the dashboard by running internal mutations. This allows you to trigger batch processing and backfill operations safely during your schema migration workflow.

Why do I need dual-write patterns for zero-downtime schema migrations?

You need dual-write patterns for zero-downtime schema migrations to maintain data consistency between old and new structures. They ensure that both schemas are updated simultaneously during the transition before the old structure is safely removed.