O que é um agente de código?

Autocomplete não é agente

Muita gente com anos de experiência usa a LLM como autocomplete caro: aceita uma sugestão de cada vez, desconfia de tudo, revisa linha por linha e não delega de verdade. Um agente recebe a tarefa inteira, decide quais arquivos abrir, edita, roda o que precisa rodar e devolve um resultado pra você revisar. A revisão muda de escala: você olha o diff e o comportamento, não cada tecla.

É por isso que o agente exige contexto montado. Ele só acerta o que consegue descobrir no código ou ler em algum arquivo: as regras do projeto, o que não tocar, o comando que prova que funcionou. O trabalho de quem conduz passa a ser escrever isso bem e revisar o que volta.

Onde o agente erra

Os erros são conhecidos e se repetem. O agente refatora três arquivos que ninguém mandou tocar, inventa uma abstração pra um caso só, usa a biblioteca que o projeto abandonou e commita direto na branch principal. Ele assume em vez de perguntar e declara pronto sem verificar.

As quatro regras que a casa escreve no arquivo de instruções de cada projeto atacam exatamente isso: pensar antes de codar e expor a dúvida em vez de esconder; simplicidade primeiro, com o código mínimo que resolve; mudanças cirúrgicas, só no que a tarefa exige; e execução orientada a objetivo, com um critério de sucesso definido e verificado antes de dizer que acabou.

Vários agentes ao mesmo tempo

Quando o agente funciona, a tentação seguinte é abrir mais de um. Aí aparece o problema que piora conforme se usa mais IA: duas sessões no mesmo checkout se atropelam, uma troca a branch, a outra commita em cima, e o trabalho das duas vira um diff misto. A solução é dar a cada sessão o próprio worktree, e rodar várias em paralelo deixa de ser risco e vira o normal.

A outra metade é o gate: o que sobe passa por typecheck, build e o que mais o projeto verificar, e gate vermelho não sobe. Sem isso, agente rápido é só um jeito mais rápido de quebrar produção.

Quando isso importa

• Você usa a LLM só pra completar linha, vê gente com menos base entregando mais rápido e quer saber o que eles fazem de diferente.
• Você vai abrir a primeira tarefa pra um agente e quer saber o que dá pra delegar e o que continua sendo seu.
• Você já roda um agente e pensa em rodar dois ou três ao mesmo tempo no mesmo projeto.

Nossa posição

O agente não dispensa quem conduz. As quatro regras que a gente escreve em todo arquivo de instruções são pra ele: pensar antes de codar, escolher o código mínimo que resolve, tocar só no que a tarefa exige e verificar o critério de sucesso antes de dizer que terminou. E o que sobe pra produção passa por um gate: vermelho não sobe.