Pensamento via Git Diff (A Arte de Revisar Alterações)

1. Visão geral do conceito e o problema sistêmico

Durante décadas, a principal habilidade de um programador foi considerada a velocidade de digitação: quantas centenas de linhas de código você consegue martelar no teclado por turno.

Na era dos agentes autônomos e do vibe coding, essa habilidade mecânica perdeu valor. Qualquer modelo de linguagem gera 1.000 linhas de código em 8 segundos. Portanto, o principal ativo do engenheiro passou a ser a arte da análise rápida de diffs (Diff-First Mindset).

Você não é mais o autor de cada símbolo individual — você é o Editor-Chefe e Arquiteto. Seu trabalho consiste em olhar para uma tela com alterações em vermelho e verde e tomar uma decisão determinística em 10 segundos:

• "O código verde está correto, mas o vermelho removeu uma verificação crítica de sessão — rejeito!"
• "As alterações são limpas, a arquitetura não foi quebrada — vamos commitar!"

Modelo mental: assim como o editor-chefe de uma revista não escreve todas as colunas sozinho, mas revisa as provas antes da impressão, o engenheiro sênior filtra a saída dos agentes através da peneira do Git Diff.

┌─────────────────────────────────────────────────────────────┐
│                 ARQUITETURA DE FILTRAGEM DIFF               │
├─────────────────────────────────────────────────────────────┤
│ 1. PROMPT PARA O AGENTE:                                    │
│    «Adicione cache de sessões via Redis no módulo auth.ts»  │
├─────────────────────────────────────────────────────────────┤
│                          │                                  │
│                          ▼ Geração Autônoma                 │
├─────────────────────────────────────────────────────────────┤
│ 2. SAÍDA BRUTA NÃO APRESENTÁVEL (4 arquivos alterados)      │
├─────────────────────────────────────────────────────────────┤
│                          │                                  │
│                          ▼ Gateway de Controle DIFF-REVIEW  │
├─────────────────────────────────────────────────────────────┤
│ 🛑 TAXONOMIA DE VERIFICAÇÃO:                                │
│    • LINHAS VERMELHAS (-): Logs e tipos foram apagados?     │
│    • LINHAS VERDES (+): Há pacotes alucinados?              │
│    • ESTATÍSTICAS: Se pediu 5 linhas, mas mudou 120 —       │
│      REJEITAR IMEDIATAMENTE!                                │
└─────────────────────────────────────────────────────────────┘

2. Exemplo de engenharia: anatomia de um diff correto

diff --git a/src/services/billing.ts b/src/services/billing.ts
--- a/src/services/billing.ts
+++ b/src/services/billing.ts
@@ -42,7 +42,9 @@ export async function calculateInvoice(user: UserProfile) {
-  // Тимчасовий хак: фіксована знижка для тестів
-  return user.cartTotal * 0.95;
+  // Перевірка активної підписки перед розрахунком
+  const discountRate = await getSubscriptionDiscount(user.id);
+  return user.cartTotal * (1 - discountRate);
 }

Ao analisar este fragmento, um engenheiro experiente verifica imediatamente três pontos:

1. Remoção (vermelho): Foi removida exatamente a dívida técnica (hack temporário), conforme solicitado no ticket.
2. Adição (verde): A chamada getSubscriptionDiscount é assíncrona e foi adicionado o await.
3. Contrato: O tipo de retorno permanece numérico, sem efeitos colaterais nos métodos vizinhos. Pode-se clicar em Accept com confiança.

3. Comandos CLI práticos para inspeção de diffs no terminal

Todas as IDEs modernas (Cursor, VS Code, Windsurf) possuem interfaces gráficas para visualização de diffs, mas o controle real é alcançado no terminal através de flags precisas do Git:

# 1. Швидка зведена статистика: скільки рядків додано/видалено у кожному файлі
git diff --stat

# 2. Перегляд змін лише для конкретного файлу без стороннього шуму
git diff src/lib/auth.ts

# 3. Перегляд змін, які вже додані до staging (перед git commit)
git diff --staged

# 4. Інтерактивний покроковий розбір (Patch Mode): дозволяє приймати або відхиляти шматки файлу (hunk) по черзі
git checkout -p

# 5. Ігнорування змін пробілів та форматування, щоб побачити чисту логіку
git diff -w --ignore-blank-lines

4. Quatro regras de ouro para a higiene na leitura de Diffs

1. Foco no vermelho (Red First): Código novo (verde) quase sempre parece elegante. As regressões mais perigosas e brechas de segurança estão sempre escondidas nas linhas vermelhas removidas.
2. Verificação de imports: Observe os primeiros 10 linhas do arquivo. O agente adicionou alguma biblioteca externa (como lodash ou axios) quando já existem ferramentas nativas no projeto?
3. Regra do limite de escopo (Diff Budget): Se você pediu ao modelo para alterar uma validação de formulário, mas o diff mostra +180 -95 linhas em 5 arquivos — não tente revisar tudo. Clique em Reject e reinicie o prompt com uma restrição rígida: "Altere apenas a função validateForm no arquivo Form.tsx, não toque no restante do código".
4. Aceite linha por linha: Evite o botão "Accept All" em arquivos complexos. Aceite as alterações bloco por bloco (Hunk by Hunk).

5. Conclusão de engenharia

O Diff-First Mindset é a principal habilidade de sobrevivência em 2026. Ele protege sua base de código contra degradação gradual e lixo sintético, transformando a velocidade frenética das redes neurais em resultados de negócio estáveis e confiáveis.