// Agentes e skills //

roda no Claude Code

Uma skill para o Claude Code que faz o Claude mudar o banco de dados de um sistema em produção em passos que não quebram nada: coluna nova, valor novo, regra nova, renomear, remover. Serve a qualquer banco relacional com migrations versionadas; os exemplos são Postgres. O Claude escreve as migrations, ensaia, simula e confere; aplicar em produção é decisão sua, e a skill só aplica quando você pede. A regra central: entre um passo e o seguinte o sistema continua no ar com metade da mudança, então cada passo precisa funcionar sozinho. Por isso a migration só acrescenta, a estrutura chega ao banco antes do código que a usa, e a subida segue a ordem banco, dados, código. Ela começa lendo a pasta de migrations e descobrindo que tipo de mudança você quer: uma mudança de um passo, uma mudança em etapas, uma regra redefinida, uma remoção, a ida a produção ou um deploy que quebrou depois da migration. O que ela entrega: a disciplina em oito regras, cada uma com o motivo; receitas por tipo de mudança (valor de enum, coluna obrigatória, renomear, trocar tipo, remover e tabela grande); a ordem de subida, com duas perguntas respondidas antes (o código novo funciona com o banco antigo? o antigo funciona com o banco novo?); simulação antes de escrever dados; conferência depois de aplicar, com consultas prontas para ver se o objeto existe, se a função manteve as proteções e se o histórico bate com os arquivos; quatro fichas de consulta; cinco moldes em Postgres que rodam em ordem do zero; um roteiro de subida para preencher, a lista que você lê e autoriza; e um conferidor, o conferir.py, que só lê a pasta de migrations e o git e acusa migration alterada depois de aplicada, comando destrutivo, valor de enum criado e usado no mesmo arquivo, função que perdeu a proteção ao ser redefinida e versão repetida ou fora de ordem. Limites: a skill não aplica nada em produção sem o seu pedido, não remove dado sem a sua autorização e não restaura cópia de segurança. Saiu de um sistema em produção com Postgres e um banco pequeno, que só acrescentou: renomear, trocar tipo, remover, preencher tabela grande e voltar atrás estão escritos como receita e marcados "a conferir", então ensaie antes. Os moldes rodaram em Postgres 17.11; para MySQL, SQLite, SQL Server e Oracle a skill dá a ordem das decisões e diz o que conferir, e nada foi executado neles. Não cobre desenhar o modelo de dados do zero, cópia de segurança, troca de banco nem réplicas. O conferidor lê texto: não interpreta SQL, não sabe o que está aplicado em ambiente nenhum e só lê arquivos .sql; não achar não prova que não há. O que é próprio do Supabase está na skill irmã app-com-supabase. Requisitos: Python 3.8 ou mais novo e git, só para o conferidor, que usa só a biblioteca padrão, não acessa a rede e não conecta em banco nenhum. Para instalar, descompacte o .zip em ~/.claude/skills/.

• Roda no Claude Code
• Intermediário