modifying-database

name	modifying-database
description	Define el flujo para crear y aplicar cambios de base de datos con Supabase en este proyecto. Usar cuando se requiera modificar el schema de la base datos, crear migraciones SQL, ejecutar migraciones, o recuperar una base local con migraciones corruptas.

Modifying Database

Proposito

Usa este skill para aplicar cambios de base de datos en este proyecto con un flujo simple y consistente usando Supabase CLI.

Cuando aplicar

Aplicar automaticamente cuando el usuario pida:

• crear o editar tablas, columnas, indices, constraints o politicas RLS
• generar una migracion
• correr migraciones locales
• recuperar una base local cuando las migraciones estan corruptas

Flujo obligatorio

1) Crear archivo de migracion

Generar la migracion en modo no interactivo con:

supabase migration new nombre_migracion --yes

Esto crea un archivo SQL nuevo en el directorio de migraciones de Supabase.

Regla obligatoria para agentes:

• usar siempre --yes para evitar prompts interactivos que puedan dejar el comando colgado
• en ejecucion automatizada, preferir tambien CI=1 (por ejemplo: CI=1 supabase migration new nombre_migracion --yes)

2) Escribir el cambio de base de datos

Editar el archivo generado y agregar el SQL necesario para el cambio (DDL/DML segun corresponda).

Reglas practicas:

• mantener cambios pequenos y enfocados por migracion
• usar nombres de migracion descriptivos
• evitar mezclar cambios no relacionados en un mismo archivo

3) Ejecutar migracion

Aplicar migraciones con:

supabase migration up

4) (Opcional) Recuperacion por migraciones corruptas

Si el historial de migraciones local esta corrupto o inconsistente, resetear la base con:

supabase db reset

Despues del reset, volver a validar que la base levanta con las migraciones esperadas.

Checklist rapido

• Crear migracion con supabase migration new nombre_migracion --yes
• Escribir SQL en el archivo creado
• Ejecutar supabase migration up