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
Software não é entregue. É mantido
A palavra entrega sugere fim. Não existe fim. Existe o dia em que você para de melhorar e continua pagando, e é aí que a maioria dos projetos feitos com IA se perde.
ManifestoAgente com método é alavanca. Sem método é passageiro sem freio
Todo argumento que eu fiz sobre revisar o que a IA escreve vale em dobro quando ela executa sozinha. A diferença é que agora o erro acontece enquanto você não está olhando.
ManifestoVibecoding com engenharia é o que separa velocidade de dívida
Todo mundo agora constrói rápido. A velocidade deixou de ser diferencial no dia em que virou commodity. O que sobra pra diferenciar é o que acontece depois que o código funciona.