Muitas pessoas usam o Claude Code para escrever código, na verdade ainda permanecem na fase de “onde está errado, conserte lá”.

Essa também é uma das formas mais fáceis de estragar um projeto, e nos últimos dias tenho seguido a ideia de especialistas, constantemente modificando e aprimorando o projeto.
Porque os bugs em projetos reais geralmente não são pequenos buracos isolados.
Quando você vê uma mensagem de erro, uma página com problemas ou um botão que não funciona, é muito provável que seja apenas um detalhe pontual que surgiu de um problema maior no sistema.
Se você simplesmente entregar esse detalhe ao AI e dizer “me ajude a consertar”, é bem provável que ele só alivie esse detalhe.
Na superfície, tudo parece resolvido, mas a lógica subjacente não foi modificada.
Na próxima vez, em um cenário diferente, o mesmo problema explode novamente.
E na próxima, você continua adicionando patches, na verdade todos com a mesma lógica de erro.
No final, o código está cheio de patches, o projeto funciona cada vez mais, mas também fica cada vez mais difícil de mexer.
Por isso, agora ao usar o Claude Code, tenho um hábito muito importante:
Não pedir para ele alterar o código imediatamente, primeiro fazer com que ele analise por que o problema aconteceu.
Prefiro perguntar assim:
Primeiro, não conserte.
Ajude-me a analisar a causa raiz por trás desse problema.
Pode ser que uma camada de design, fluxo de estado, estrutura de dados ou condição de fronteira esteja com problema?
Nesse momento, o papel da AI muda.
Ela não é mais uma “empresa terceirizada para consertar bugs”, mas sim uma “pessoa que ajuda a investigar o sistema”.
Essa diferença é enorme.
O que você fornece a ela também não deve ser apenas uma mensagem de erro, mas sim o máximo de contexto possível: arquivos relacionados, cadeia de chamadas, fluxo de operações do usuário, resultado esperado, resultado real, o que foi alterado anteriormente.
Quanto mais completo for o contexto, mais ela poderá ajudar a identificar o verdadeiro problema, e não apenas colocar um remendo na superfície.