schematize
Skills · Claude Code · Agent Skills

Postgres betreiben, ohne die Produktion zu gefährden — ohne Verhandlung.

Sicheres DDL auf Live-Tabellen, EXPLAIN vor dem Indexieren, gesundes Vacuum, ein Pooler davor und ein Backup, das nur mit getestetem Restore zählt. Das Schema-Design gehört zu schematize-database; hier geht es um die Engine.

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

Betreut von Lucas Andrade

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

Nicht verhandelbare Mindeststandards

Werden nie abgeschaltet, "um schneller zu sein". Vollständige Liste in der Skill.

Nur unterstützte Major-Versionen

Produktion läuft nie auf einer Major ohne Support; das EOL steht im Kalender, das Upgrade wird mit Rollback geprobt.

Kein DDL ohne lock_timeout

Jedes DDL auf einer Live-Tabelle beginnt mit lock_timeout und Retry: Eine Migration, die auf einen Lock wartet, blockiert alle nachfolgenden Abfragen.

Indizes und Constraints ohne Blockade

CREATE INDEX CONCURRENTLY und neue Constraints als NOT VALID mit anschließendem VALIDATE; die Tabelle nie unter ACCESS EXCLUSIVE neu schreiben.

Messen vor dem Indexieren

pg_stat_statements in jedem Cluster aktiv und ein echter Plan mit EXPLAIN (ANALYZE, BUFFERS); ohne sie ist „es ist langsam" nur eine Vermutung.

Autovacuum und Pooler

Autovacuum nie abgeschaltet, Wraparound überwacht, niedriges max_connections und PgBouncer vor der Anwendung.

Backup mit getestetem Restore

Basis-Backup + kontinuierliches WAL (PITR), verschlüsselt, mit automatisiertem Restore und gemessenem RPO/RTO; pg_dump ist nicht das maßgebliche Backup.

Minimale Rechte und RLS

Migrations-Rolle getrennt von der Anwendungs-Rolle, scram-sha-256 mit TLS, und RLS mit FORCE und fail-closed bei Mandantenfähigkeit.

Befehle

Installiert in .claude/commands/. Führe /pg-help jederzeit aus.

/pg-backupPrüft Backup/PITR und baut die Restore-Probe mit gemessenem RPO/RTO auf.
/pg-ccContext compact: schreibt Kontext + Checkliste ins Archiv und führt /compact aus.
/pg-claudeErstellt oder fügt die Immer-an-CLAUDE.md für Postgres im Repo-Root zusammen (überschreibt keine Blöcke anderer Skills).
/pg-explainLiest einen EXPLAIN-(ANALYZE, BUFFERS)-Plan und schlägt Index oder Umschreibung vor, ohne Lock erstellt.
/pg-handoffSchreibt das Kontext-Handoff ohne Kompaktierung — Sitzungsende oder Aufgabenwechsel.
/pg-helpListet alle Befehle auf.
/pg-loadLädt zwingend den gesamten normativen Inhalt: Version und Konfiguration, EXPLAIN, Vacuum, Locks, Pooling, Replikation, Backup, Upgrade und RLS.
/pg-migrateWandelt eine Schemaänderung in sichere Schritte für eine Live-Tabelle um (Expand, Backfill in Batches, Contract) und führt das Gate aus.
/pg-reviewPrüft Migrationen und Konfiguration: führt das Gate check-pg-migration.sh aus und liest, was die Maschine nicht liest.
/pg-upgradePlant das Major-Upgrade (pg_upgrade oder logisch) mit Probe, Rollback und Checkliste.

Für KI-Agenten

Ohne menschliches Eingreifen installieren. Metadaten in llms.txt.

  • Ausführen: git clone https://github.com/schematizeme/skill-postgres.git && ./skill-postgres/install.sh
  • Oder herunterladen: https://github.com/schematizeme/skill-postgres/releases/latest/download/skill-postgres.zip und nach .claude/skills/ entpacken
  • Kopiere assets/CLAUDE.md in das Repo-Root (Immer-an-Regel).
  • Bestätige mit /pg-help.

Nicht installieren wollen?

Lies die vollständigen Standards und kopiere sie direkt in dein Projekt — oder installiere die Skill, damit der Agent sie selbst durchsetzt.

GitHub →Pakete