O que fazer quando a IA te dá código que você não entende

A IA te entrega um bloco de código. Roda. Funciona. E você não faz a menor ideia de como. Tem umas linhas estranhas ali no meio que parecem magia.

A tentação é óbvia: aperta aceitar e segue. Funcionou, né? O problema aparece três semanas depois, quando aquilo quebra e você fica olhando pra tela sem saber nem por onde começar.

Meu take: código que você não entende é código que você não mantém. Aceitar cego não é velocidade. É dívida técnica que você pega emprestado de si mesmo.

Por que isso é uma armadilha

O código que a IA escreve vira responsabilidade sua no momento que entra no projeto. Seu nome está nele. E aí:

• Quando quebra, você não sabe consertar.
• Quando precisa mudar, você não sabe onde mexer.
• Quando alguém pergunta como funciona, você não sabe responder.

Você fica refém. Refém da IA pra qualquer ajuste, refém do medo de tocar em algo que "está funcionando". Isso é o oposto de ser dono do seu projeto.

A boa notícia: você tem um professor 24h

O mesmo modelo que escreveu o código pode te explicar. E de graça. A diferença entre o vibecoder às cegas e o com engenharia está em uma pergunta a mais.

Em vez de aceitar, pergunte:

Explique este código linha por linha, em português
simples, como se eu fosse iniciante. O que cada
parte faz e por quê?

Leia a explicação. Se ainda não entendeu, insista:

Não entendi a parte X. Me dá um exemplo concreto
do que acontece ali com um dado real.

Você transforma cada trecho misterioso em aula. Cinco minutos hoje contra horas de pânico depois.

Pergunte o que dá errado

Entender o que o código faz é metade. A outra metade é entender como ele falha. Pergunte:

O que acontece se este código receber um valor
vazio, nulo, ou muito grande? Onde ele pode quebrar?

A IA costuma revelar aqui os pontos frágeis que ela mesma deixou. Aí você decide se blinda ou aceita o risco conscientemente. A diferença é essa palavra: conscientemente.

Reescreva com suas palavras

Teste final de entendimento: peça a versão que você conseguiria ter escrito.

Reescreva isso da forma mais simples e clara
possível, mesmo que fique um pouco mais longo.
Prefiro entender a ser esperto.

Muitas vezes o código "elegante" da IA é elegante demais pro seu nível. A versão mais longa e óbvia é a que você mantém. Código que você entende vale mais que código que impressiona.

Quando é ok não entender tudo

Sejamos honestos: você não vai entender cada linha de cada biblioteca. Não precisa saber como o bcrypt faz hash por dentro. Precisa saber o que ele faz e por que usar.

A linha é essa: você não precisa entender o motor do carro. Precisa saber dirigir, freiar e o que fazer quando a luz acende. Código de terceiro confiável, você usa. Código no seu projeto, você entende.

O hábito que muda tudo

Toda vez que a IA te der algo que você não entende, pare. Pergunte. Aprenda. Só então aceite.

Parece que atrasa. Não atrasa. Cada trecho que você entende hoje é um bug que você resolve sozinho amanhã. Você vai ficando mais forte enquanto o outro vibecoder vai ficando mais dependente.

Vibecoding com engenharia é usar a IA pra aprender, não pra fugir de aprender. Ela é a ferramenta mais poderosa que você já teve nas mãos. Mas quem tem que entender o que sai dela é você.

A decisão é sua.