PhuongDeveloper/landingpage

Práticas recomendadas para Postgres mantidas pela Supabase, aplicáveis a qualquer ambiente Postgres. Carregue esta skill ANTES de escrever ou alterar qualquer coisa que viva em um banco de dados Postgres: criação ou alteração de tabelas e colunas (incluindo a escolha de tipos de colunas), design de esquema, migrações e arquivos de esquema declarativos, políticas de RLS e os testes que as verificam, índices, triggers, funções de banco de dados, filas e tarefas agendadas (pg_cron, pgmq), busca vetorial/semântica (pgvector) e restauração de dumps (pg_restore) ou importação de dados. Carregue-a também ao diagnosticar consultas lentas, alto consumo de CPU, timeouts, planos EXPLAIN, exaustão de conexões, bloqueios, inchaço ou linhas visíveis para o usuário ou tenant errado. Não é apenas um guia de desempenho — tarefas de esquema, migração, segurança e criação de SQL também precisam dessas regras, mesmo para uma alteração de uma única coluna ou uma consulta simples.

O que é landingpage?

Esta skill fornece um conjunto abrangente de práticas recomendadas para Postgres, mantido pela Supabase, com foco em otimização de desempenho, design de esquema, segurança e gerenciamento de conexões. Ela é essencial para desenvolvedores e agentes de IA que trabalham com bancos de dados Postgres, independentemente do ambiente de hospedagem, abrangendo desde consultas SQL e criação de tabelas até políticas de segurança em nível de linha (RLS) e tarefas avançadas como busca vetorial (pgvector). A skill organiza suas regras em 8 categorias prioritárias, de 'crítico' a 'baixo', guiando o usuário por práticas que evitam problemas comuns de desempenho e segurança. Suporta plataformas como Claude Code, Cursor e Codex, sendo ativada automaticamente ao detectar a necessidade de escrever SQL, alterar esquemas ou diagnosticar problemas de banco de dados. Seu uso garante que qualquer alteração no banco de dados siga as melhores práticas da comunidade Postgres e da Supabase, reduzindo riscos de lentidão, falhas de segurança e inconsistências.

Funciona com~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/PhuongDeveloper/landingpage/tree/HEAD/.agents/skills/supabase-postgres-best-practices

Documentação

Práticas Recomendadas para Postgres da Supabase

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

Quando Aplicar

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 escalonamento
Otimizar para recursos específicos do Postgres
Trabalhar com Segurança em Nível de Linha (RLS)

Categorias de Regras por Prioridade

Prioridade	Categoria	Impacto	Prefixo
1	Desempenho de Consultas	CRÍTICO	`query-`
2	Gerenciamento de Conexões	CRÍTICO	`conn-`
3	Segurança e RLS	CRÍTICO	`security-`
4	Design de Esquema	ALTO	`schema-`
5	Concorrência e Bloqueios	MÉDIO-ALTO	`lock-`
6	Padrões de Acesso a Dados	MÉDIO	`data-`
7	Monitoramento e Diagnóstico	BAIXO-MÉDIO	`monitor-`
8	Recursos Avançados	BAIXO	`advanced-`

Como Usar

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

references/query-missing-indexes.md
references/query-partial-indexes.md
references/_sections.md

Cada arquivo de regra contém:

Breve explicação de por que é importante
Exemplo SQL incorreto com explicação
Exemplo SQL correto com explicação
Saída opcional do EXPLAIN ou métricas
Contexto adicional e referências
Notas específicas da Supabase (quando aplicável)