O checklist que eu sigo antes de aceitar código que a IA escreveu
Faz uns meses que quase todo código que eu escrevo passa pela IA antes (Claude Code, Cursor). Ganhei muita velocidade, mas comecei a ver um tipo de bug que antes eu quase não tinha. O código compila, passa no lint, o diff parece ok, e mesmo assim alguma coisa quebra lá na frente, normalmente num lugar que eu nem pedi pra mexer.
Depois de levar umas pancadas, montei um checklist que sigo antes de aceitar qualquer mudança que a IA fez. Compartilho aqui porque talvez ajude alguém.
-
Ler o diff inteiro. O resumo que a IA escreve no final conta o que ela queria fazer, e nem sempre bate com o que ela fez de fato.
-
Desconfiar de teste escrito na mesma sessão. Ele costuma testar a implementação nova e não o comportamento que você esperava. E se a IA alterou um teste antigo pra ele passar, eu paro tudo e vou ver o porquê, porque muitas vezes o teste tava certo.
-
Olhar os arquivos que ela mexeu sem eu pedir. Pedi pra ajustar um formulário e veio alteração no hook de auth? Quero entender antes de aceitar.
-
Conferir dependência nova. Se o pacote existe mesmo, se é o certo, se a versão faz sentido. Já vi nome de pacote inventado.
-
Testar fora do caminho feliz. Campo vazio, null, lista sem item, erro de rede. A IA escreve muito pensando no cenário em que tudo dá certo.
-
Ver quem consome o que mudou. Esse é o que mais me pegou. Exemplo bem comum: a IA refatora a API de cadastro pra ler
emailAddress, mas o form continua mandandoemail. O TypeScript não reclama, os testes unitários passam, e o usuário fica clicando num botão que não faz nada. -
Rodar os fluxos principais num navegador de verdade. Cadastro, login, checkout. O que não pode quebrar eu quero ver funcionando do jeito que o usuário usa, sem mock.
Esse último item virou um projeto open source que eu tô mantendo, o stillworks. Você descreve as jornadas como uma lista de passos e cada passo é Playwright normal:
// journeys.config.ts
import { defineConfig } from "stillworks";
export default defineConfig({
baseURL: "http://localhost:3000",
journeys: [
{
name: "signup",
steps: [
{ name: "Open the signup page", run: ({ page }) => page.goto("/signup") },
{
name: "Fill in email and password",
run: async ({ page }) => {
await page.getByLabel("Email").fill(`test+${Date.now()}@example.com`);
await page.getByLabel("Password").fill("correct-horse-battery-staple");
},
},
{ name: "Submit the form", run: ({ page }) => page.getByRole("button", { name: "Create account" }).click() },
{ name: "See the welcome screen", run: ({ page }) => page.getByText("Welcome").waitFor() },
],
},
],
});
E pra rodar:
npx stillworks init
npx stillworks run --url http://localhost:3000
Quando alguma jornada quebra ele gera um REPORT.md com o passo que falhou, os erros do console, as requests que deram erro (com a resposta do servidor) e um print da tela. A ideia é você colar isso direto no Claude Code ou no Cursor. No caso do emailAddress ali de cima, o relatório já mostra o POST /api/signup voltando 500 com o TypeError, então o agente vai direto no ponto.
Tem integração pronta com Claude Code (--claude, que cria um comando /verify), Cursor (--cursor) e GitHub Actions rodando nos previews da Vercel (--github).
-
Prestar atenção redobrada em segurança. Já peguei validação no servidor removida "pra simplificar", segredo hardcoded e query montada com concatenação de string.
-
Pedir mudanças pequenas. Diff de 40 linhas eu revejo de verdade. Diff de 600 eu confesso que só passo o olho.
É isso. Vocês fazem algo diferente? Já tiveram bug em produção que veio de código da IA e passou batido pelos testes? Curioso pra saber o que adicionariam.
O repo tá aqui pra quem quiser testar ou contribuir: https://github.com/valmirjunior2109-spec/stillworks
Se tiver algum fluxo da sua stack que você queria ver como template (Next + Supabase, Clerk, Stripe...), abre uma issue lá.
Em paralelo tô construindo a Publishub, que vai ser a versão que roda sozinha em todo PR e compara com a última versão que funcionava. Ainda não tá pronta, mas quem quiser entrar na lista de acesso antecipado (é grátis): https://getpublishub.com/?utm_source=tabnews#early-access