Skip to content
Back to skills

Db Expand Contract

ASecurity

Divide una migración en el plan de dos fases expand y contract, separa lo aditivo de lo destructivo y avisa de lo que no se puede partir sin reescribir la tabla.

  • 2 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 18, 2026
ai-agentsgobashsql

Security analysis

A100/100

Scanned November 18, 2026

npx -y skills add alberto2005-coder/skills-ia --skill db-expand-contract --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Db Expand Contract?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Db Expand Contract
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/alberto2005-coder-db-expand-contract/badge)](https://www.skillsdirectory.com/skills/alberto2005-coder-db-expand-contract)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: db-expand-contract
description: Divide una migración en el plan de dos fases expand y contract, separa lo aditivo de lo destructivo y avisa de lo que no se puede partir sin reescribir la tabla.
license: MIT
metadata:
  package: db-architect
  version: "1.2.0"
---

# DB Expand Contract

## Objetivo

Desplegar un cambio de esquema sin ventana de mantenimiento: primero se añade lo nuevo y se escribe en los dos lados, después se retira lo viejo. Una migración que mezcla las dos cosas obliga a parar la aplicación.

## Instrucciones de ejecución

1. Genera el plan antes de aplicar nada:

```bash
py db-architect/scripts/expand_contract.py --path migrations/004_cambio.sql --json
```

2. Aplica la fase `expand`, despliega el código que escribe en el formato nuevo y solo entonces la fase `contract`.
3. Cada aviso se resuelve con su alternativa, no posponiéndolo.

## Fases

| Fase | Sentencias | Cuándo se aplica |
|---|---|---|
| `expand` | `CREATE TABLE`, `ADD COLUMN`, `CREATE INDEX [CONCURRENTLY]`, `ADD CONSTRAINT … NOT VALID`, `VALIDATE CONSTRAINT` | Antes del despliegue del código |
| `contract` | `DROP TABLE`, `DROP COLUMN`, `DROP CONSTRAINT`, `RENAME`, `SET NOT NULL`, `ALTER … TYPE` | Después de que el código nuevo esté estable |
| `unknown` | Cualquier sentencia que el analizador no reconoce (`DROP INDEX`, `INSERT`, …) | Nunca: se revisa a mano |

`deployable_together` es `false` cuando la migración mezcla las dos fases o trae alguna desconocida: entonces necesita dos despliegues, no uno más largo.

## Avisos

| Regla | Por qué |
|---|---|
| `columna-obligatoria-en-un-paso` | `ADD COLUMN … NOT NULL` no se puede repartir: columna nullable, relleno y apriete |
| `rename-no-divisible` | Un `RENAME` rompe el código viejo: columna nueva, doble escritura y retirada |
| `reescritura-no-divisible` | `ALTER … TYPE` reescribe la tabla: columna nueva con el tipo final y copia por lotes |
| `sentencia-desconocida` | No se puede colocar en una fase sin saber si añade o retira |

## Límites

- Lee SQL textual: no conoce el estado real de la base ni qué código está desplegado.
- No genera el relleno de datos ni la doble escritura; marca dónde van.
- Un cambio de tipo que PostgreSQL resuelve sin reescribir (por ejemplo, ampliar `varchar`) se avisa igual: el análisis no distingue versiones del motor.

## Gate de salida

- Plan con las dos fases por escrito y el número de despliegues que necesita.
- Cada aviso con su alternativa aplicada o su aceptación explícita.
- La migración aplicada queda enganchada a `db-lock-audit` para revisar el bloqueo de cada fase.

## Handoff

Entrega a `db-lock-audit` cada fase para medir su bloqueo, a `db-migration-guard` la reversión de las dos y a `db-drift` el esquema que debería quedar tras el contrato.

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.