~/VibeHandbook
PDF grátis

Capítulo 15 · 05

Lendo diffs com espírito crítico

Um diff é a lista exata do que mudou: linhas vermelhas removidas, linhas verdes adicionadas. Ler diffs é o hábito de maior alavancagem no vibe coding, porque é onde você pega a IA fazendo algo que você não pediu.

Você não precisa entender cada linha. Procure por estes sinais de alerta:

  • Arquivos que você não esperava que mudassem. Por que um arquivo de configuração foi tocado?
  • Código apagado. Ela removeu uma verificação de validação, um tratador de erro, ou um teste "para fazer passar"?
  • Segredos ou valores fixos no código. Chaves de (Application Programming Interface — Interface de Programação de Aplicações), senhas, ou URLs (Uniform Resource Locators — endereços web) que não deveriam estar no código.
  • Verificações desativadas. Um teste pulado, uma proteção comentada, um // @ts-ignore, ou uma permissão afrouxada.
  • Aumento de escopo. Mudanças distantes do que você pediu.

Se algo parecer estranho, pergunte: "Explain why you changed X — I didn't ask for that." Faça a IA justificar exclusões especialmente. "Estava causando um erro" é uma razão para entender o erro, não para apagar a verificação.

Uma forma prática de criar o hábito: leia o diff antes de aceitar a mudança, nunca depois. Assim que o código é mesclado e o aplicativo parece funcionar, você nunca mais vai voltar e lê-lo — não há atrito forçando isso. O momento da revisão precisa ser o momento da decisão. Ferramentas ajudam aqui: git diff --stat te dá um resumo de uma linha por arquivo, para que um arquivo inesperado salte aos olhos imediatamente, e revisar em uma página de mostra a mudança inteira em uma única visão rolável, em vez de espalhada pelo seu editor.

Quer offline?

Baixe o livro inteiro em PDF ou EPUB — grátis.