schematize
Skills · Claude Code · Agent Skills

Opera Postgres sin tumbar producción — sin negociación.

DDL seguro en tablas vivas, EXPLAIN antes de indexar, vacuum sano, un pooler delante y un backup que solo vale con restore probado. El diseño del esquema es de schematize-database; aquí está el motor.

v0.2.0Disciplina · Banco/PostgreSQLgithub.com/schematizeme/skill-postgres

Mantenido por Lucas Andrade

schematize-postgres · v0.2.0bash
$ schematize install postgres
GitHub →descargar skill (.zip)/postgres-help · github.com/schematizeme/schematize-cli

Pisos no negociables

No se apagan "para ir más rápido". Lista completa en la skill.

Solo major soportada

Producción nunca corre una major fuera de soporte; el EOL entra en el calendario y el upgrade se ensaya con rollback.

Ningún DDL sin lock_timeout

Todo DDL en una tabla viva empieza con lock_timeout y reintento: la migración que espera un lock bloquea todas las consultas posteriores.

Índices y constraints sin bloquear

CREATE INDEX CONCURRENTLY y constraints nuevas como NOT VALID seguidas de VALIDATE; nunca reescribir la tabla bajo ACCESS EXCLUSIVE.

Medir antes de indexar

pg_stat_statements activo en todo clúster y plan real con EXPLAIN (ANALYZE, BUFFERS); sin eso, "va lento" es una suposición.

Autovacuum y pooler

Autovacuum nunca apagado, wraparound vigilado, max_connections bajo y PgBouncer delante de la aplicación.

Backup con restore probado

Backup base + WAL continuo (PITR), cifrado, con restore automatizado y RPO/RTO medidos; pg_dump no es el backup de record.

Mínimo privilegio y RLS

El rol de migración es distinto del de la aplicación, scram-sha-256 con TLS, y RLS con FORCE y fail-closed en multi-tenant.

Comandos

Instalados en .claude/commands/. Usa /pg-help cuando quieras.

/pg-backupAudita backup/PITR y monta el ensayo de restore con RPO/RTO medidos.
/pg-ccContext compact: escribe contexto + checklist en el archivo y ejecuta /compact.
/pg-claudeCrea o fusiona el CLAUDE.md siempre activo de Postgres en la raíz (no sobrescribe bloques de otras skills).
/pg-explainLee un plan EXPLAIN (ANALYZE, BUFFERS) y propone el índice o la reescritura, creado sin lock.
/pg-handoffEscribe el handoff de contexto sin compactar — fin de sesión o cambio de tarea.
/pg-helpLista todos los comandos.
/pg-loadCarga a la fuerza todo el cuerpo normativo: versión y config, EXPLAIN, vacuum, locks, pooling, replicación, backup, upgrade y RLS.
/pg-migrateConvierte un cambio de esquema en pasos seguros para tabla viva (expand, backfill por lotes, contract) y ejecuta el gate.
/pg-reviewRevisa migraciones y config: ejecuta el gate check-pg-migration.sh y lee lo que la máquina no lee.
/pg-upgradePlanifica el upgrade de major (pg_upgrade o lógico) con ensayo, rollback y checklist.

Para agentes de IA

Instala sin intervención humana. Metadatos en llms.txt.

  • Ejecuta: git clone https://github.com/schematizeme/skill-postgres.git && ./skill-postgres/install.sh
  • O descarga: https://github.com/schematizeme/skill-postgres/releases/latest/download/skill-postgres.zip y descomprime en .claude/skills/
  • Copia assets/CLAUDE.md a la raíz del repo (regla siempre activa).
  • Confirma con /pg-help.

¿No quieres instalar?

Lee las normas completas y cópialas directo a tu proyecto — o instala la skill para que el agente las aplique solo.

GitHub →Paquetes