Melhores Práticas do Supabase Postgres

Guia abrangente de otimização de desempenho para Postgres, mantido pelo Supabase. Contém regras em 8 categorias, priorizadas pelo impacto para guiar a otimização automatizada de consultas e o design de esquemas.

Quando Usar

Consulte estas diretrizes quando:

• Escrever consultas SQL ou projetar esquemas
• Implementar índices ou otimização de consultas
• Revisar problemas de desempenho do banco de dados
• Configurar pooling de conexões ou escalabilidade
• Otimizar para recursos específicos do Postgres
• Trabalhar com Segurança em Nível de Linha (RLS)

Categorias de Regras por Prioridade

Como Usar

Leia os arquivos de regras individuais para explicações detalhadas e exemplos de SQL:

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

Cada arquivo de regra contém:

• Breve explicação do porquê é importante
• Exemplo de SQL incorreto com explicação
• Exemplo de SQL correto com explicação
• Saída opcional de EXPLAIN ou métricas
• 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

Quando Usar

Esta habilidade é aplicável para executar o fluxo de trabalho ou as ações descritas na visão geral.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como substituta para validação específica do ambiente, testes ou revisão de especialistas.
• Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.