schematize
Skills · Claude Code · Agent Skills

Exploitez Postgres sans faire tomber la production — sans négociation.

DDL sûr sur tables vivantes, EXPLAIN avant d’indexer, vacuum sain, un pooler devant et une sauvegarde qui ne vaut que restaurée et testée. La conception du schéma relève de schematize-database ; ici, c’est le moteur.

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

Maintenu par Lucas Andrade

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

Socles non négociables

Jamais désactivés "pour aller plus vite". Liste complète dans la skill.

Seulement des majeures supportées

La production ne tourne jamais sur une majeure hors support ; l’EOL entre au calendrier et la montée de version est répétée avec un rollback.

Aucun DDL sans lock_timeout

Tout DDL sur une table vivante commence par lock_timeout et un retry : une migration qui attend un verrou bloque toutes les requêtes suivantes.

Index et contraintes sans blocage

CREATE INDEX CONCURRENTLY et nouvelles contraintes en NOT VALID puis VALIDATE ; jamais de réécriture de la table sous ACCESS EXCLUSIVE.

Mesurer avant d’indexer

pg_stat_statements actif sur chaque cluster et plan réel via EXPLAIN (ANALYZE, BUFFERS) ; sans cela, « c’est lent » reste une supposition.

Autovacuum et pooler

Autovacuum jamais désactivé, wraparound surveillé, max_connections bas et PgBouncer devant l’application.

Sauvegarde avec restauration testée

Sauvegarde de base + WAL continu (PITR), chiffrée, avec restauration automatisée et RPO/RTO mesurés ; pg_dump n’est pas la sauvegarde de référence.

Moindre privilège et RLS

Le rôle de migration diffère de celui de l’application, scram-sha-256 avec TLS, et RLS avec FORCE et fail-closed en multi-tenant.

Commandes

Installées dans .claude/commands/. Lancez /pg-help à tout moment.

/pg-backupAudite sauvegarde/PITR et monte la répétition de restauration avec RPO/RTO mesurés.
/pg-ccContext compact : écrit contexte + checklist dans l'archive et lance /compact.
/pg-claudeCrée ou fusionne le CLAUDE.md toujours actif de Postgres à la racine (n'écrase pas les blocs d'autres skills).
/pg-explainLit un plan EXPLAIN (ANALYZE, BUFFERS) et propose l’index ou la réécriture, créé sans verrou.
/pg-handoffÉcrit le handoff de contexte sans compacter — fin de session ou changement de tâche.
/pg-helpListe toutes les commandes.
/pg-loadCharge de force tout le corpus normatif : version et config, EXPLAIN, vacuum, verrous, pooling, réplication, sauvegarde, upgrade et RLS.
/pg-migrateTransforme un changement de schéma en étapes sûres pour une table vivante (expand, backfill par lots, contract) et lance le gate.
/pg-reviewRévise migrations et config : lance le gate check-pg-migration.sh et lit ce que la machine ne lit pas.
/pg-upgradePlanifie la montée de version majeure (pg_upgrade ou logique) avec répétition, rollback et checklist.

Pour les agents IA

Installez sans intervention humaine. Métadonnées dans llms.txt.

  • Lancez : git clone https://github.com/schematizeme/skill-postgres.git && ./skill-postgres/install.sh
  • Ou téléchargez : https://github.com/schematizeme/skill-postgres/releases/latest/download/skill-postgres.zip et décompressez dans .claude/skills/
  • Copiez assets/CLAUDE.md à la racine du repo (règle toujours active).
  • Confirmez avec /pg-help.

Pas envie d'installer ?

Lisez les normes complètes et copiez-les directement dans votre projet — ou installez la skill pour que l'agent les applique tout seul.

GitHub →Packs