Como ele age: editar, criar e conferir

Editar um trecho ou criar do zero

Terminada a exploracao, o agente age, e agir tem formas diferentes. A mais comum e editar: mudar um trecho específico de um arquivo que já existe, trocando um pedaco por outro. E uma ação cirurgica, que mexe só no necessário e deixa o resto intacto, o que facilita a sua revisão. Quando algo precisa nascer do zero, como um arquivo de teste novo ou um módulo inteiro, entra a criação, que escreve um arquivo novo. E, para colocar as mudanças a prova ou executar tarefas, entra rodar comando, que dispara algo no terminal, como os testes, o build ou um comando do git.

Todas essas ações passam pela sua aprovação no modo padrão, e agora você entende por que: elas mudam o projeto ou o ambiente. A edição mostra exatamente o trecho antigo e o novo, para você comparar antes de aceitar. A criação mostra o arquivo que vai nascer. O comando mostra o que sera executado. Esse e o momento de exercer o volante que você aprendeu no módulo anterior: ler com atenção e aprovar só o que faz sentido. Como a edição e cirurgica, revisar costuma ser rápido, bastando conferir se a troca proposta resolve o que você queria.

O agente que confere o próprio trabalho

Aqui esta talvez o hábito mais valioso de um bom uso do Claude Code: fazer o agente conferir o próprio trabalho. Depois de editar, ele não deveria simplesmente declarar vitoria; deveria rodar o que comprova que a mudança funcionou, como os testes ou o build, e só então dizer que terminou. Esse fechamento do ciclo, agir e depois verificar, e o que separa uma correção de verdade de uma que só parece certa. Um código pode compilar e ainda estar errado; um teste que passa da uma garantia bem mais forte do que a impressão de que ficou bom.

A boa noticia e que você pode e deve pedir isso explicitamente. Ao formular o pedido, inclua o critério de sucesso e o pedido de conferir: corrija o bug e rode os testes para confirmar que passam. Assim o agente já incorpora a verificacao no próprio fluxo. Se ele disser que terminou sem ter rodado nada, e um sinal de alerta: peca para ele conferir. Com o tempo, essa exigencia de provar que funcionou vira automática, e a qualidade do que você aceita sobe bastante, porque nada é dado como pronto sem evidencia.

Vale lembrar que a verificacao do agente não substitui a sua. Ele rodar os testes e ótimo, mas você ainda revisa a mudança e decide se ela resolve o problema certo, e não só se os testes passaram. As vezes o teste passa e o comportamento ainda não é o que o usuário quer, porque o teste cobria outra coisa. A dupla ideal e o agente conferindo tecnicamente, com testes e build, e você conferindo o sentido, se aquilo era mesmo o que você pediu. Duas camadas de conferencia deixam o resultado bem mais confiavel.

Por que a ação cirurgica ajuda você

Ha uma razão prática para o agente preferir editar trechos a reescrever arquivos inteiros: a sua revisão fica muito mais fácil. Quando ele troca só as linhas necessárias, você vê exatamente o que mudou, um antes e um depois curtos, e aprova em segundos. Se ele reescrevesse o arquivo todo, você teria que reler tudo para achar a diferença, e erros passariam despercebidos. Por isso, mudanças pequenas e focadas não são só mais elegantes; são mais seguras, porque cabem na sua cabeça e no seu tempo de revisão.

Com explorar e agir dominados, você já entende o essencial do fluxo do Claude Code: ele mapeia o terreno, muda o necessário e, bem conduzido, confere o resultado. As próximas duas aulas adicionam as camadas que elevam isso de bom para excelente: como o agente pensa e planeja antes de agir, e como ele encontra e corrige os próprios erros quando algo da errado. São essas camadas que fazem a diferença entre um agente que atropela e um que trabalha com método, e você vai aprender a estimular a segunda.