schematize
Skills · Claude Code · Agent Skills

Opere o Postgres sem derrubar a produção — sem negociação.

DDL seguro em tabela viva, EXPLAIN antes de indexar, vacuum saudável, pooler na frente e backup que só vale com restore testado. O desenho do schema é da schematize-database; aqui é o motor.

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

Mantido por Lucas Andrade

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

Pisos inegociáveis

Não se desligam "pra ir mais rápido". Lista completa na skill.

Só major suportada

Produção nunca roda major fora de suporte; o EOL entra no calendário e o upgrade é ensaiado, com rollback.

Sem DDL sem lock_timeout

Todo DDL em tabela viva começa com lock_timeout e retry: a migration que espera lock bloqueia todas as queries seguintes.

Índice e constraint sem bloquear

CREATE INDEX CONCURRENTLY e constraints novas como NOT VALID seguidas de VALIDATE; nada de reescrever a tabela sob ACCESS EXCLUSIVE.

Medir antes de indexar

pg_stat_statements ligado em todo cluster e plano real com EXPLAIN (ANALYZE, BUFFERS); sem isso, "está lento" é palpite.

Autovacuum e pooler

Autovacuum nunca desligado, wraparound vigiado, max_connections baixo e PgBouncer na frente da aplicação.

Backup com restore testado

Base + WAL contínuo (PITR), cifrado, com restore automatizado e RPO/RTO medidos; pg_dump não é o backup de record.

Menor privilégio e RLS

Role de migration diferente da da aplicação, scram-sha-256 com TLS, e RLS com FORCE e fail-closed em multi-tenant.

Comandos

Instalados em .claude/commands/. Use /pg-help a qualquer momento.

/pg-backupAudita backup/PITR e monta o ensaio de restore com RPO/RTO medidos.
/pg-ccContext compact: gera contexto + checklist no archive e roda /compact.
/pg-claudeCria ou mescla o CLAUDE.md sempre-on de Postgres na raiz (não sobrescreve blocos de outras skills).
/pg-explainLê um plano EXPLAIN (ANALYZE, BUFFERS) e propõe o índice ou a reescrita, criado sem lock.
/pg-handoffGera o handoff de contexto sem compactar — fim de sessão ou troca de tarefa.
/pg-helpLista todos os comandos.
/pg-loadCarrega à força o corpo normativo: versão e config, EXPLAIN, vacuum, locks, pooling, replicação, backup, upgrade e RLS.
/pg-migrateTransforma uma mudança de schema em passos seguros para tabela viva (expand, backfill em lotes, contract) e roda o gate.
/pg-reviewRevisa migrations e config: roda o gate check-pg-migration.sh e lê o que a máquina não lê.
/pg-upgradePlaneja o upgrade de major (pg_upgrade ou lógico) com ensaio, rollback e checklist.

Para agentes de IA

Instale sem intervenção humana. Metadados em llms.txt.

  • Rode: git clone https://github.com/schematizeme/skill-postgres.git && ./skill-postgres/install.sh
  • Ou baixe: https://github.com/schematizeme/skill-postgres/releases/latest/download/skill-postgres.zip e descompacte em .claude/skills/
  • Copie assets/CLAUDE.md para a raiz do repo (regra sempre-on).
  • Confirme com /pg-help.

Não quer instalar?

Leia as normativas completas e copie direto pro seu projeto — ou instale a skill para o agente aplicar sozinho.

GitHub →Pacotes