schematize
Skills · Claude Code · Agent Skills

Gestisci Postgres senza fermare la produzione — senza negoziare.

DDL sicuro su tabelle vive, EXPLAIN prima di indicizzare, vacuum in salute, un pooler davanti e un backup che vale solo con restore testato. Il disegno dello schema è di schematize-database; qui c’è il motore.

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

Gestito da Lucas Andrade

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

Basi non negoziabili

Non si spengono "per andare più veloce". Elenco completo nella skill.

Solo major supportate

La produzione non gira mai su una major fuori supporto; l’EOL entra nel calendario e l’upgrade è provato con rollback.

Nessun DDL senza lock_timeout

Ogni DDL su una tabella viva inizia con lock_timeout e retry: una migration in attesa di un lock blocca tutte le query successive.

Indici e constraint senza bloccare

CREATE INDEX CONCURRENTLY e nuovi constraint come NOT VALID seguiti da VALIDATE; mai riscrivere la tabella sotto ACCESS EXCLUSIVE.

Misurare prima di indicizzare

pg_stat_statements attivo in ogni cluster e piano reale con EXPLAIN (ANALYZE, BUFFERS); senza, "è lento" è solo un’ipotesi.

Autovacuum e pooler

Autovacuum mai spento, wraparound sorvegliato, max_connections basso e PgBouncer davanti all’applicazione.

Backup con restore testato

Backup base + WAL continuo (PITR), cifrato, con restore automatizzato e RPO/RTO misurati; pg_dump non è il backup di riferimento.

Minimo privilegio e RLS

Il ruolo di migration è diverso da quello dell’applicazione, scram-sha-256 con TLS, e RLS con FORCE e fail-closed in multi-tenant.

Comandi

Installati in .claude/commands/. Usa /pg-help quando vuoi.

/pg-backupVerifica backup/PITR e prepara la prova di restore con RPO/RTO misurati.
/pg-ccContext compact: scrive contesto + checklist nell'archivio ed esegue /compact.
/pg-claudeCrea o unisce il CLAUDE.md sempre attivo di Postgres nella radice (non sovrascrive blocchi di altre skill).
/pg-explainLegge un piano EXPLAIN (ANALYZE, BUFFERS) e propone l’indice o la riscrittura, creato senza lock.
/pg-handoffScrive l'handoff di contesto senza compattare — fine sessione o cambio attività.
/pg-helpElenca tutti i comandi.
/pg-loadCarica a forza l’intero corpo normativo: versione e config, EXPLAIN, vacuum, lock, pooling, replica, backup, upgrade e RLS.
/pg-migrateTrasforma una modifica di schema in passi sicuri per una tabella viva (expand, backfill a lotti, contract) ed esegue il gate.
/pg-reviewRivede migration e config: esegue il gate check-pg-migration.sh e legge ciò che la macchina non legge.
/pg-upgradePianifica l’upgrade di major (pg_upgrade o logico) con prova, rollback e checklist.

Per agenti IA

Installa senza intervento umano. Metadati in llms.txt.

  • Esegui: git clone https://github.com/schematizeme/skill-postgres.git && ./skill-postgres/install.sh
  • Oppure scarica: https://github.com/schematizeme/skill-postgres/releases/latest/download/skill-postgres.zip e decomprimi in .claude/skills/
  • Copia assets/CLAUDE.md nella radice del repo (regola sempre attiva).
  • Conferma con /pg-help.

Non vuoi installare?

Leggi le norme complete e copiale direttamente nel tuo progetto — oppure installa la skill perché l'agente le applichi da solo.

GitHub →Pacchetti