Postgresql

Cursor-Regel für konsistentes PostgreSQL-Schema, sinnvolle Indizes und saubere Migrationen.

Original-Beschreibung der Autoren: PostgreSQL production rules. Safe migrations, parameterized queries, TIMESTAMPTZ, proper indexing strategy.

Die Regel

---
description: "PostgreSQL production rules. Safe migrations, parameterized queries, TIMESTAMPTZ, proper indexing strategy."
globs: **/*.sql, **/migrations/**/*.sql, **/schema.sql, **/seed.sql
alwaysApply: false
---
# PostgreSQL Rules

Expert PostgreSQL developer. Safe migrations, parameterized queries, proper indexing.

## Schema
- TIMESTAMPTZ for all timestamps (not TIMESTAMP without timezone)
- UUID for public IDs, BIGSERIAL for internal keys
- NOT NULL by default — nullable only when intentional
- FK with explicit ON DELETE behavior
- Check constraints for domain invariants

## Queries
- Parameterized always — never string interpolation
- SELECT explicit columns, never SELECT *
- LIMIT on all potentially large result sets
- EXPLAIN ANALYZE before shipping complex queries

## Indexes
- Index every FK column
- CREATE INDEX CONCURRENTLY for live tables (non-blocking)
- Partial indexes for frequently filtered subsets
- Remove unused indexes

## Migrations
- Versioned files: V001__create_table.sql
- Large column additions: multi-step with backfill
- Test rollback before deploying

## Transactions
- Explicit BEGIN/COMMIT for multi-statement changes
- statement_timeout to prevent runaway queries
- SELECT ... FOR UPDATE for row locking

## Forbidden
- No SELECT *
- No string-interpolated SQL
- No schema changes during peak traffic
- No plaintext passwords in DB
- No TRUNCATE in app code

So nutzt du sie

Die Regel kopieren (Button oben) oder als Datei herunterladen und im Projekt unter .cursor/rules/ ablegen — Cursor lädt sie beim nächsten Start automatisch. Ältere Cursor-Versionen lesen alternativ eine einzelne .cursorrules-Datei im Projektstamm; dort einfach den Regel-Text ohne den Kopfblock zwischen den ----Zeilen einfügen.

Der Regel-Text ist englisch — Cursor versteht ihn unabhängig von der Sprache, in der Sie mit dem Editor chatten.

Im Detail

Eine Cursor-Regel, die der KI feste Konventionen für PostgreSQL-Code vorgibt: konsistente Schema-Benennung, sinnvolle Indizierung und sauber strukturierte Migrationen. Damit lässt sich vermeiden, dass KI-generiertes SQL von Prompt zu Prompt unterschiedlich aussieht oder Anti-Patterns wie fehlende Indizes auf Fremdschlüsseln enthält. Besonders hilfreich für Teams, die viel Datenbankcode per KI generieren lassen und langfristig ein wartbares, einheitliches Schema behalten wollen, statt Migrationen nachträglich aufräumen zu müssen. Ersetzt kein Datenbank-Know-how, reduziert aber wiederkehrende Reviewkommentare zu Stil und Struktur spürbar.

Praxis-Tipp

Bei einem Prompt wie „Lege eine Migration für eine users-Tabelle mit E-Mail-Index an“ erzwingt die Regel automatisch konsistente Namens- und Index-Konventionen.

Lizenz & Quelle

• Lizenz: CC0 1.0
• Quelle: PatrickJS/awesome-cursorrules (GitHub)

Lade …