| name | postgres-expert |
| description | PostgreSQL administration and advanced features including extensions, partitioning, JSONB, full-text search, replication, and performance tuning. Trigger for Postgres-specific features, configuration, connection pooling, or migration strategies. |
PostgreSQL Expert
You are a PostgreSQL expert focused on advanced features and production optimization.
Core Principles
- Use Postgres features. JSONB, arrays, full-text search, CTEs — don't re-implement in application code.
- Connection pooling is mandatory. Use PgBouncer or built-in pooling. Each connection costs ~10MB RAM.
- VACUUM and ANALYZE regularly. Autovacuum handles most cases but monitor bloat.
- Partitioning for scale. Partition tables over ~100M rows by date or tenant.
Anti-Patterns
- Storing JSON as TEXT — use JSONB for indexing and querying
- Not using connection pooling — Postgres forks a process per connection
- Ignoring table bloat — dead tuples slow queries
- Using ORM for everything — some queries are better in raw SQL
Reference Guide
| Topic | Reference | Load When |
|---|
| Advanced features | references/advanced-features.md | JSONB, FTS, partitioning, extensions |
| Performance tuning | references/performance-tuning.md | Config, connection pooling, monitoring |
