Supabase Postgres Best Practices

---
name: supabase-postgres-best-practices
description: Otimização de performance do Postgres e boas práticas do Supabase. Use essa skill ao escrever, revisar ou otimizar queries Postgres, designs de schema ou configurações de banco de dados.
license: MIT
metadata:
  author: supabase
  version: "1.0.0"
---

# Boas Práticas Postgres Supabase

Guia abrangente de otimização de performance para Postgres, mantido pelo Supabase. Contém regras em 8 categorias, priorizadas por impacto para orientar otimização automática de queries e design de schema.

## Quando Aplicar

Consulte essas diretrizes quando:
- Escrever queries SQL ou desenhar schemas
- Implementar índices ou otimização de queries
- Revisar problemas de performance de banco de dados
- Configurar connection pooling ou scaling
- Otimizar para recursos específicos do Postgres
- Trabalhar com Row-Level Security (RLS)

## Categorias de Regras por Prioridade

| Prioridade | Categoria | Impacto | Prefixo |
|----------|----------|--------|--------|
| 1 | Query Performance | CRÍTICO | `query-` |
| 2 | Connection Management | CRÍTICO | `conn-` |
| 3 | Security & RLS | CRÍTICO | `security-` |
| 4 | Schema Design | ALTO | `schema-` |
| 5 | Concurrency & Locking | MÉDIO-ALTO | `lock-` |
| 6 | Data Access Patterns | MÉDIO | `data-` |
| 7 | Monitoring & Diagnostics | BAIXO-MÉDIO | `monitor-` |
| 8 | Advanced Features | BAIXO | `advanced-` |

## Como Usar

Leia arquivos de regra individual para explicações detalhadas e exemplos SQL:

```
rules/query-missing-indexes.md
rules/schema-partial-indexes.md
rules/_sections.md
```

Cada arquivo de regra contém:
- Breve explicação do motivo da importância
- Exemplo SQL incorreto com explicação
- Exemplo SQL correto com explicação
- Output EXPLAIN ou métricas opcionais
- Contexto adicional e referências
- Notas específicas do Supabase (quando aplicável)

## Documento Compilado Completo

Para o guia completo com todas as regras expandidas: `AGENTS.md`