# Convex Migrate

> Migra el schema y rellena datos en una app Convex desplegada usando @convex-dev/migrations.

Fuente: https://skillsagentes.com/skills/get-convex/agent-skills/convex-migrate
Markdown: https://skillsagentes.com/skills/get-convex/agent-skills/convex-migrate.md

Repositorio: https://github.com/get-convex/agent-skills
Autor: get-convex
Licencia: Apache-2.0
Actualizado: el mes pasado
Coste de contexto: 21 tok instalada, 255 tok al activarse, 255 tok con todos los archivos del bundle
Bundle: 1 archivo, 1020 B
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add get-convex/agent-skills --skill convex-migrate --agent claude-code
# Cursor
npx -y skills add get-convex/agent-skills --skill convex-migrate --agent cursor
# Codex
npx -y skills add get-convex/agent-skills --skill convex-migrate --agent codex
# Gemini CLI
npx -y skills add get-convex/agent-skills --skill convex-migrate --agent gemini
# Windsurf
npx -y skills add get-convex/agent-skills --skill convex-migrate --agent windsurf
# Cline
npx -y skills add get-convex/agent-skills --skill convex-migrate --agent cline
```

## Qué hace

- Guía el cambio de esquema en una app Convex desplegada sin romper datos existentes
- Instala @convex-dev/migrations y escribe una migración que transforma o rellena filas antiguas
- Ejecuta la migración y verifica que todas las filas quedan válidas antes de endurecer el validador

## Cuándo usarla

- Al cambiar el schema de una app Convex ya desplegada con datos reales
- Al necesitar hacer backfill de datos existentes tras añadir o modificar un campo

## Qué la activa

- "Necesito añadir un campo obligatorio a una tabla de Convex ya en producción"
- "Cómo hago backfill de datos en Convex con @convex-dev/migrations"
- "Quiero cambiar el schema sin romper las filas existentes en mi app Convex"

## Antes de instalar

- Requiere instalar el paquete @convex-dev/migrations en el proyecto Convex.

## Archivos

- SKILL.md — 1020 B

## SKILL.md

Reproducido tal cual desde get-convex/agent-skills bajo Apache-2.0. Esta sección es el documento original y está en inglés.

<!-- 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.

## Dónde encaja

- Categoría: [Bases de datos](https://skillsagentes.com/categorias/bases-de-datos.md) — Diseño de esquemas, migraciones y optimización de consultas.
- Creador: [get-convex](https://skillsagentes.com/creators/get-convex.md) — 33 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Convex Quickstart](https://skillsagentes.com/skills/get-convex/agent-skills/convex-quickstart.md): Levanta un template Next.js + Convex barebones a partir de una idea en una frase.
- [Convex Design](https://skillsagentes.com/skills/get-convex/agent-skills/convex-design.md): Diseña y construye backends reactivos y type-safe de nivel producción en Convex: schema, queries/mutations/actions, índices, auth, storage, scheduling, multiplayer en tiempo real y workflows LLM/agentes.
- [Convex Authz](https://skillsagentes.com/skills/get-convex/agent-skills/convex-authz.md): Audita y refuerza la autorización de una app Convex: impersonación por identity-from-arg, checks de ownership por documento faltantes, queries públicas que filtran datos por un id del cliente y escrituras en un contenedor ajeno.
- [Convex Expert](https://skillsagentes.com/skills/get-convex/agent-skills/convex-expert.md): Especialista en el backend de Convex: código dentro de convex/ (funciones, schemas, índices, queries, mutations, actions, endpoints HTTP, cron jobs, storage, auth y componentes).
- [Convex Agent](https://skillsagentes.com/skills/get-convex/agent-skills/convex-agent.md): Añade un backend de agente de IA / RAG (@convex-dev/agent) a la app Convex.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)