Conceptos básicos de las habilidades del agente

.cursor/skills/
├── explain-review/
│   └── SKILL.md
├── migration-safety/
│   └── SKILL.md
├── failover-drill/
│   └── SKILL.md
└── incident-triage/
    └── SKILL.md

## Pila fija
- PostgreSQL 18.4 (servidor y cliente psql)
- pgBackRest 2.55+ (copia de seguridad autoalojada)
- Patroni 4.x / RDS Multi-AZ (por ADR del clúster)
- Flyway 10+ o Liquibase 4+ (ejecutor de migraciones)

# Habilidad de Seguridad de Migración
 
## Qué hace esta habilidad
Evalúa el riesgo de bloqueo de DDL y propone un orden de implementación más seguro.
 
## Cuándo invocar
- El PR añade ALTER TABLE, CREATE INDEX o FK
- Migración de tabla grande sin expandir-contraer
 
## Entradas (requerido)
- Ruta del archivo SQL de migración
- Estimación del número de filas de la tabla
- Entorno de destino (staging/producción)
- Política de ventana de mantenimiento
 
## Salidas
- Puntuación de riesgo de bloqueo (bajo/medio/alto)
- Alternativa DDL más segura si aplica
- Verificación: psql -f migración en staging + consulta de monitorización de bloqueos
 
## Barreras de seguridad
- Nunca sugerir índice no CONCURRENTLY en tablas activas de producción
- Nunca ejecutar DDL en el agente sin aprobación humana
- Requerir SQL de reversión en el PR
 
## Pila fija
PostgreSQL 18.4 · Flyway 10+
 
## Ejemplos de prompts
Ver §10 abajo.

## Pila fija (requerido)
- PostgreSQL 18.4 - NO sintaxis obsoleta sin justificación
- CREATE INDEX CONCURRENTLY - NO CREATE INDEX simple en OLTP de producción
- Las columnas IDENTITY se prefieren sobre SERIAL para tablas nuevas (idiomas de PG 18)

## Política de invocación del equipo
1. Nombra la habilidad en el prompt: "Usar Habilidad de Seguridad de Migración en V20260709__add_index.sql"
2. Adjunta la salida de la consulta de tamaño de tabla si está disponible
3. El agente debe generar SQL de verificación antes de declarar que ha terminado
4. El humano ejecuta la migración en staging antes de la aprobación de producción
5. Nunca fusionar automáticamente PRs de migración generados por habilidades sin revisión de DBA

## Barreras de seguridad
- No DDL de producción desde el agente sin ID de ticket
- No pg_terminate_backend sin evidencia de PID bloqueador
- No DROP DATABASE / TRUNCATE sin un punto de control de copia de seguridad nombrado
- EXPLAIN debe usar (ANALYZE, BUFFERS) en staging, no en producción por defecto
- Se requiere SQL de reversión para cada migración hacia adelante

-- Verificación en staging
BEGIN;
\i db/migrations/V20260709__add_index.sql
SELECT locktype, mode, granted FROM pg_locks WHERE relation = 'orders'::regclass;
ROLLBACK;

flyway -url=jdbc:postgresql://staging:5432/myapp migrate
psql "$STAGING_URL" -c "SELECT indexname FROM pg_indexes WHERE tablename = 'orders';"

docs/skills/README.md          # índice con disparadores de invocación
.cursor/skills/                # Rutas nativas de Cursor

# Índice de Habilidades de Experto en Postgres
| Habilidad | Disparador | Propietario |
|---|---|---|
| explain-review | PR de consulta | rotación de app + DBA |
| migration-safety | PR de DDL | DBA de plataforma |
| failover-drill | trimestral | SRE |
| incident-triage | SEV1/2 base de datos | de guardia |

Prompt: "Usar Habilidad de Seguridad de Migración en V12__fk.sql, luego Habilidad de Revisión de EXPLAIN en la consulta ORM vinculada"
 
Orden:
1. Evaluar riesgo de bloqueo de DDL
2. Si es medio o superior, proponer CONCURRENTLY o expandir-contraer
3. Revisar el plan SELECT de la aplicación después de que exista el índice

Usar Habilidad de Revisión de EXPLAIN:
- PR: #842 consulta de lista de pedidos
- Adjuntar: EXPLAIN (ANALYZE, BUFFERS) desde staging
- Tabla: orders ~45M filas
- Salida: lista de verificación de pasar/fallar + sugerencia de índice si es necesario

Usar Habilidad de Simulacro de Failover:
- Topología: Patroni 4.x, 3 nodos, etcd
- Destino: solo clúster de staging
- Salida: failover paso a paso + SQL de verificación + reversión al primario anterior