rc-sqllisted
Install: claude install-skill rodolfochicone/rc-project
# Banco de dados (SQL) — guias por tarefa
Guias práticos de SQL. Leia o guia da tarefa em `references/` antes de agir — cada um traz
o checklist, os comandos de verificação e os critérios de aceite. Sempre leia o schema e os
índices reais (via `\d`, `information_schema` ou o DDL do repo) antes de recomendar qualquer
mudança; não presuma a estrutura. Os exemplos usam PostgreSQL, mas os princípios valem para
qualquer banco relacional.
## Roteamento
| Tarefa | Guia |
| ------ | ---- |
| Otimização de queries (EXPLAIN, índices, N+1, paginação) | `references/query-optimization.md` |
| Design de schema (normalização, tipos, constraints, chaves) | `references/schema-design.md` |
| Segurança e execução (transações, locks, migrations, produção) | `references/safety.md` |
## Princípios sempre válidos
- **Meça com EXPLAIN antes de otimizar — não adivinhe.** Nenhum ajuste de índice ou query se justifica sem o plano de execução real na frente.
- **O índice certo bate a query esperta.** Antes de reescrever uma query complexa, verifique se falta um índice.
- **Read-only por padrão (Rule 9).** Para análise, só `SELECT`/`EXPLAIN`; escrita e DDL vão no relatório como recomendação, para o usuário executar ou autorizar. O hook `db-guard` bloqueia escrita via `psql`/`mysql`/`sqlite3` no Bash — é rede de segurança, não a regra: acesso via MCP passa por fora dele.
- **O schema é o alicerce.** Corrija o schema antes de contornar sua falha em código (validação duplicada, joins gambiarra, etc.).