Manifesto
Por que ler todo código que a IA entrega
Parece perda de tempo. Parece desconfiança. Parece o oposto de ganhar velocidade com IA. É a única prática que separa quem opera a ferramenta de quem é operado por ela.
Toda vez que eu falo isso, alguém revira os olhos.
Ler todo código que a IA entrega parece o oposto de ganhar velocidade. Parece desconfiar de uma ferramenta que funciona bem. Parece rigor de quem gosta de dificuldade.
Não é nada disso. É a diferença entre operar a ferramenta e ser operado por ela.
Não é sobre desconfiar da IA
Começo por aqui porque é o mal-entendido mais comum.
A IA erra menos que a maioria das pessoas na maior parte das tarefas. Isso já é verdade e não é o ponto.
O ponto é que ela erra diferente. Erro humano tem hesitação junto: a pessoa avisa que não tem certeza, pergunta, deixa um comentário. Erro de IA vem com a mesma confiança e a mesma fluência do acerto. Não existe sinal na superfície.
E quando o erro não se anuncia, a única forma de encontrar é olhando.
O que você perde quando não lê
Três coisas, e a terceira é a que ninguém conta.
Perde a capacidade de consertar. No dia em que quebrar, e vai quebrar, quem está lá é você. Se você nunca leu, não vai consertar. Vai pedir pra IA consertar algo que você não sabe descrever, e a chance de piorar é alta.
Perde a capacidade de perceber. Bug normal aparece sozinho: a tela quebra, alguém reclama. Falha de segurança não aparece. O sistema roda perfeito com o banco aberto pra internet inteira. Só quem lê vê isso.
Perde o aprendizado. Essa é a mais cara no longo prazo. Cada trecho que você lê ensina alguma coisa. Quem lê durante um ano vira outra pessoa profissionalmente. Quem só aceita fica exatamente onde estava, e depende cada vez mais da ferramenta.
O argumento da velocidade não se sustenta
"Mas eu perco o ganho de velocidade."
Faz a conta. A IA acelerou a escrita, que era a parte lenta, de horas. Ler um trecho leva minutos.
Você trocou horas por minutos e está reclamando dos minutos.
E a comparação honesta nem é essa. É entre ler agora e depurar depois um sistema que você não conhece. Qualquer um que já passou pelo segundo cenário aceita o primeiro sem discutir.
O que "ler" quer dizer aqui
Não é conferir linha por linha, e não é virar revisor profissional.
É entender o formato: o que esse bloco faz, de onde vem o dado, o que ele decide, o que devolve, o que acontece se der errado.
Na prática, quatro perguntas resolvem quase tudo:
- que dado entra aqui
- quem pode chamar isso
- o que acontece quando falha
- isso está guardando algo que não devia
Se você consegue responder as quatro, leu o suficiente. É a camada 2 do Protocolo de 5 Camadas, e é a que sustenta as outras quatro.
A parte incômoda
Vou reconhecer o que é desconfortável nisso.
Ler expõe o que você não sabe. Você bate num trecho, não entende, e tem que admitir. Aceitar é mais confortável porque preserva a sensação de que está tudo sob controle.
Só que sensação de controle não é controle. E o dia em que a diferença aparece é sempre o pior dia possível.
Não entender é informação, não é vergonha. É exatamente o lugar onde você precisa parar e perguntar.
O que está em jogo
Sistema que ninguém entende é sistema que ninguém pode mudar. Vira caixa-preta que funciona até parar de funcionar, e aí não tem quem conserte.
É isso que eu chamo de vibecoding às cegas. Não é usar IA. É usar sem olhar.
Delegar a escrita é inteligente. Delegar o entendimento é abrir mão do controle do que leva o seu nome.
Você não precisa escrever cada linha. Precisa poder responder por cada uma.
A decisão é sua.
Perguntas frequentes
Perguntas rápidas
+Ler tudo não anula o ganho de velocidade da IA?
Não, porque o que a IA acelera é a escrita, que era a parte lenta. Ler um trecho leva minutos e a escrita levava horas. O ganho continua enorme, só deixa de ser cego.
+E se eu não entender o que estou lendo?
Aí você achou exatamente o que precisava achar. Peça explicação, leia de novo, pergunte o porquê de cada decisão. Não entender é informação, não é vergonha. O erro é aceitar mesmo sem entender.
+Preciso ler linha por linha?
Não. Precisa entender o que cada bloco faz, de onde vem o dado, o que é decidido e o que é devolvido. Leitura de estrutura resolve a maior parte; linha por linha só onde há risco real.
+Isso vale mesmo para projeto pequeno?
Vale mais ainda, porque projeto pequeno é onde o hábito se forma barato. Quem só começa a ler quando o projeto fica grande já perdeu a chance de entender como ele foi construído.
Continue lendo
Manifesto: por que eu construo (e ensino) vibecoding com engenharia
Não vendo mágica nem medo. Rodo empresas reais 100% em vibecoding: e acredito que IA é alavanca para quem tem método, não atalho para quem não sabe.
NegóciosComo escolher entre construir e contratar pronto
Com IA, construir ficou tão barato que virou o reflexo. Existem três perguntas que decidem melhor que o instinto, e o padrão continua sendo comprar.
IA & CarreiraPor que arquitetura não se delega pra IA
A IA escreve a função melhor e mais rápido que você. Mas decidir onde essa função mora, quem pode chamar ela e o que acontece quando ela falha continua sendo seu.