Setup de agentes de IA: o que devs usam de verdade
Alguém abriu um Ask HN perguntando qual é o setup de agentes de IA de cada um, e o fio virou o que esses fios sempre viram: um monte de dev mostrando a própria bancada. Tem gente com cinco agentes rodando em paralelo. Tem gente que usa só um terminal e um arquivo de instruções. E tem gente que desistiu e voltou para o autocomplete. Eu li e me reconheci em quase todas as fases. Por isso resolvi contar o que aprendi montando meu próprio setup de agentes de IA e o que eu acho que importa de verdade.
Por que todo mundo está perguntando a mesma coisa
Há um ano e pouco, a pergunta era "qual modelo você usa?". Hoje o modelo virou quase detalhe. Os bons estão bem próximos uns dos outros. O que separa uma sessão produtiva de uma tarde perdida é o que fica em volta do modelo:
- o contexto que você entrega para ele;
- as ferramentas que ele pode chamar;
- o quanto ele pode fazer sem te pedir permissão;
- como você confere o que ele fez.
Ninguém tem a resposta pronta porque o terreno mudou rápido demais. Cada um foi montando a sua gambiarra. Fios como esse são basicamente uma troca de gambiarras, e isso é ótimo. É assim que a ferramenta amadurece de verdade, longe do material de marketing.
O que um setup de agentes de IA precisa ter
Depois de testar bastante coisa, o meu se resume a quatro peças. Nenhuma é exótica.
1. Um agente no terminal. Ele lê o repositório, roda comando, edita arquivo. Eu prefiro terminal a extensão de IDE porque o agente enxerga o que eu enxergo: os scripts do package.json, os testes, o git status.
2. Um arquivo de instruções do projeto. É o item que mais rende e o que mais gente ignora. Um markdown na raiz explicando como o projeto funciona. Não precisa ser longo:
# Projeto
- Monorepo com Bun workspaces. Apps em apps/, libs em packages/.
- Rodar testes: bun test (nunca npm test).
- Banco: PostgreSQL. Migrations em packages/db/migrations, nunca editar uma já aplicada.
- Páginas novas usam o componente PageLayout.
- Não rodar build de vários apps ao mesmo tempo.
Cinco linhas assim evitam umas vinte correções por semana. O agente não adivinha que você usa Bun. Se você não disser, ele vai rodar npm install e criar um package-lock.json que ninguém pediu.
3. Permissões bem definidas. Leitura e testes rodam livres. Commit, push, deploy e qualquer coisa que apague dados pedem confirmação. Parece burocracia até o dia em que o agente decide "limpar" uma pasta que não era dele.
4. Um jeito rápido de verificar. Testes, type-check, lint. Se o agente consegue rodar isso sozinho e ler o erro, ele se corrige. Se não consegue, você vira o compilador humano dele.
Vale a pena rodar vários agentes em paralelo?
Essa é a parte do fio que mais chama atenção. Gente rodando três, quatro, oito agentes ao mesmo tempo, cada um em uma branch ou worktree separada. Soa como o futuro.
Minha opinião: para a maioria dos devs, não vale. Pelo menos não ainda.
O gargalo nunca foi o agente digitar. O gargalo é você revisar. Um agente gera em dez minutos um diff que leva vinte para revisar com atenção. Com quatro rodando, você vira um revisor de PR em tempo integral, e cansado. Revisor cansado aprova coisa errada.
Agente que escreve mais rápido do que você consegue revisar só adianta o próximo bug.
Onde o paralelo funciona bem é em tarefa independente e fácil de conferir. Exemplo real: atualizar o mesmo padrão de import em quarenta arquivos, ou gerar testes para funções puras que já existem. O resultado é binário, passou ou não passou. Aí sim, pode soltar a matilha.
Para feature nova com decisão de arquitetura, eu fico com um agente só e acompanho de perto.
MCP, subagentes e o risco de colecionar ferramenta
Outro padrão comum é o setup cheio de servidores MCP: banco, GitHub, Slack, navegador, gerenciador de tarefas, tudo plugado. Eu já fiz isso. Tinha mais ferramenta conectada do que usava em uma semana.
O problema é que cada ferramenta tem custo:
- ocupa contexto, porque a descrição dela vai junto em toda conversa;
- confunde o modelo, que às vezes escolhe a ferramenta errada;
- consome recurso, e servidor MCP parado no background comendo CPU é mais comum do que parece.
Hoje eu ligo o que o projeto precisa e desligo o resto. Banco local e GitHub cobrem 90% do meu dia. O navegador entra quando estou mexendo em front e quero que o agente veja a tela que ele mesmo quebrou.
Subagentes seguem a mesma lógica. São úteis para pesquisa ampla, tipo "ache todos os lugares que chamam essa função", porque devolvem só a conclusão e não enchem seu contexto de arquivo. Para tarefa pequena, delegar custa mais do que fazer direto. Um subagente sabe só o que você escreveu no pedido. Se o pedido for ruim, a resposta vem errada com a maior confiança do mundo.
O que muda no seu fluxo de trabalho
A mudança mais concreta que eu senti não foi escrever menos código. Foi escrever mais texto. Descrever bem uma tarefa virou uma habilidade técnica de verdade.
Um pedido como "arruma o login" rende um diff aleatório. Algo assim rende um diff que dá para revisar:
O login com Google falha quando o usuário já tem conta por e-mail.
Erro em apps/web/src/auth/callback.ts, linha do upsert.
Quero: vincular a conta Google à conta existente pelo e-mail.
Não mexer no fluxo de e-mail/senha. Adicionar um teste para o caso.
Repare que é o mesmo texto que você mandaria para um colega júnior. Quem já escrevia boas issues está em vantagem. Quem escrevia "não funciona, vê aí" vai sofrer de novo, agora com uma máquina.
Outras mudanças práticas que eu adotei:
- Commits menores. Peço para o agente parar depois de cada etapa. Fica mais fácil reverter.
- Testes antes. Quando o teste existe, o agente tem um alvo. Sem teste, ele declara vitória por conta própria.
- Leitura do diff inteiro. Sempre. O agente adora "aproveitar" e refatorar uma coisa que você não pediu.
E um cuidado de bolso: rodar agente é rodar processo. Type-check, build e testes em loop esquentam a máquina e gastam cota de CI. Se o seu notebook vira um aquecedor toda vez que você abre uma sessão, o problema provavelmente está no seu setup, e não no modelo.
Qual é o melhor setup, afinal?
O mais chato possível. Um agente, um arquivo de instruções bem escrito, permissões conservadoras e testes que rodam rápido. Depois disso, cada peça nova precisa resolver um problema que você já teve, não um problema que você imagina que vai ter.
O fio do HN é divertido justamente porque mostra que ninguém chegou no setup definitivo. Quem diz que chegou geralmente está vendendo um curso. Eu sigo ajustando o meu a cada projeto, e a melhor configuração que tenho hoje foi a que mais perdeu ferramenta ao longo do tempo.
Se quiser ver onde esse fluxo está rodando na prática, dá uma olhada nos projetos que eu mantenho.
Resumo para o LinkedIn
Tem dev rodando oito agentes de IA em paralelo. Eu fiquei com um só. Li um Ask HN sobre setup de agentes e me reconheci em quase todas as fases. Hoje o modelo pesa pouco. O que decide é o que você coloca em volta dele. O meu setup é bem sem graça: um agente no terminal, um arquivo de instruções do projeto, permissões conservadoras e testes rápidos. Cinco linhas de markdown me poupam umas vinte correções por semana. Agente em paralelo parece o futuro, mas o gargalo nunca foi a digitação. O gargalo é a revisão. Agente que escreve mais rápido do que você revisa só adianta o próximo bug. A melhor configuração que eu tenho hoje é justamente a que mais perdeu ferramenta com o tempo. E o seu setup, está crescendo ou enxugando? Conta aqui nos comentários. #IA #AgentesDeIA #DesenvolvimentoDeSoftware #Produtividade #DevTools