Ricardo Mello. Engenheiro full-stack sênior, pirado em performance e AI

← artigos ai · ferramentas 8 min

Você não precisa de superpoderes. Precisa de contexto.

Toda tecnologia nova traz junto um pacote de metodologias prontas prometendo te ensinar a usá-la do jeito certo. Não seria diferente com os agentes de IA.

Basta abrir o LinkedIn pra ver alguém instalando um plugin aleatório que promete transformar o Claude Code num time inteiro de engenheiros. Brainstorm, SDD, TDD, subagente revisando subagente. E aí a pessoa muda a forma que trabalha há vinte anos pra caber dentro do fluxo do plugin.

Isso funciona com muitas pessoas? Sim, mas se você é um dev experiente, você já acumulou uma bagagem absurda que pode e deve ser amplificada com os agentes ao invés de recomeçar do zero.

E só um disclaimer aqui: eu sou contra a síndrome de gabriela, por favor não me entenda mal. O ponto é que na nossa área surgem tantas coisas novas todos os dias, que é importante saber diferenciar hype de tendência, e isso tem se tornado mais difícil a cada dia.

Eu também instalei. Usei o superpowers por meses, testei as skills do Matt Pocock, e continuo com os dois instalados. Mas percebi uma coisa olhando os meus próprios logs: eles quase não são usados. E não foi porque eu desativei.

“é importante saber diferenciar hype de tendência, e isso tem se tornado mais difícil a cada dia.”

O que esses plugins fazem

Sendo justo: os plugins são muito bons. O superpowers é bem pensado, e várias das skills dele são exatamente o que um dev sênior faz no automático: entender o problema antes de sair codando, escrever um plano, rodar os testes antes de dizer que terminou, não aceitar code review sem questionar, e por aí vai.

Esse é justamente o ponto. É processo. E processo genérico, que serve pra qualquer projeto, em qualquer stack, pra qualquer pessoa. É o feijão com arroz.

O que o meu setup faz

O meu setup é menos glamouroso. Em cada projeto eu tenho um repositório que eu chamo de bridge, que fica do lado dos repositórios do projeto.

O nome bridge vem da ponte de comando do navio, onde o capitão e a equipe comandam a navegação. Pra um setup com múltiplos projetos (front-end, backend, infra, mobile, data…), é muito importante conseguir navegar entre eles e criar features de ponta a ponta. Podem me chamar de narcisista, mas eu sou o capitão e gerencio o meu projeto da minha ponte de comando.

Ela carrega:

  • um CLAUDE.md com o que só aquele workspace sabe: o que é cada repo e qual agente cuida dele, qual a branch padrão dos PRs em cada um, a ordem quando uma feature cruza repos (a API vem primeiro), onde ficam as anotações de cada ticket;
  • um agente por stack (Angular, Flutter, Laravel, Spring Boot…), cada um conhecendo as convenções e as armadilhas daquele projeto;
  • skills pro meu fluxo de trabalho: pegar ticket do Jira, abrir ou revisar PR no GitHub/Bitbucket, consultar o banco de dev, ler logs, iniciar a stack inteira, ou escrever descrição de PR de um jeito que o time leia;
  • hooks pra garantir os padrões e a segurança, como bloquear qualquer comando que tente ler o .env.

Nada disso é genial. São coisas que eu já fazia na mão e cansei de explicar pro agente toda sessão.

E tem uma regra master que segura tudo isso de pé: defer, don’t duplicate. Cada repositório já tem o próprio CLAUDE.md com a stack, as convenções, os comandos de lint e teste. A bridge não copia nada disso. Ela sabe pra onde mandar cada tarefa, e o agente daquele repo lê as regras específicas dele antes de mexer em qualquer coisa. Importante: o Claude Code não carrega sozinho o CLAUDE.md de um repositório vizinho, então essa leitura precisa estar explícita no agente.

Segue uma lista de exemplos do mundo real:

  • Investigar um bug no backend, debugar a API, entender que ele era um problema no ETL, e abrir um PR pro repositório de data;
  • Implementar uma nova tela no front-end (Angular) e no app (Flutter), além de identificar um bug no endpoint que havia sido desenvolvido por outro time, subindo um PR pra correção;
  • Planejar, desenvolver, e testar um CRUD com front-end (React) e back-end (Java) com direito a gravação de evidência.

A ideia é sempre usar agentes específicos pra cada repo, e deixar eles trabalharem enquanto você direciona o navio.

Os números

Fui contar nos transcripts do Claude Code de um projeto de cliente, que somam umas 270 sessões nas últimas semanas.

Skills invocadas Vezes
As minhas (PR no Bitbucket, Jira, descrição de PR, consulta no banco, subir o backend local, review…) 226
As do superpowers (brainstorming, writing-plans, subagent-driven-development…) 19

Com os subagentes foi a mesma coisa: o agente de Spring Boot foi chamado 78 vezes, o de code review 41 e o de frontend 40.

E sim, esse número é enviesado. O superpowers dispara pouco porque os meus agentes e skills ganham na hora em que o modelo escolhe o que usar. Não é prova de que o plugin é ruim. É sinal de que, quando existe uma opção específica, o modelo prefere ela. Eu também.

Processo vs. contexto

O que uma skill agrega é proporcional ao que ela ensina de novo pro modelo.

O Claude sabe fazer TDD. Sabe escrever um plano e sabe fazer brainstorm. Ele leu mais livro de engenharia de software do que eu e você juntos. Uma skill que ensina isso pra ele tá ensinando o que ele já sabe.

Agora, o Claude não sabe que o PR da API vai pra dev e não pra main. Ele não sabe que o Karma do projeto Angular tá quebrado e que só o build de produção pega erro de template. Também não sabe que a homologação tem um banco por cliente, nem que o time não lê descrição de PR com mais de 20 linhas.

Processo é commodity. Contexto não é. É a mesma ideia do meu último post: o que tem valor nunca foi a parte genérica.

O custo que ninguém mostra

Plugin de processo não é de graça. A minha bridge também carrega contexto em toda sessão, mas é contexto do meu projeto. O superpowers injeta no início de toda sessão um bloco com essa pérola:

If you think there is even a 1% chance a skill might apply to what you are doing, you ABSOLUTELY MUST invoke the skill.

Tudo em caixa alta, competindo com as regras do meu CLAUDE.md. Quando eu perguntei pro Claude se valia escrever esse artigo, a regra do plugin mandava ele abrir uma sessão de brainstorming antes de responder. Era só uma pergunta.

E o custo não é só desse plugin. Quando fui medir, das 40 skills que eu adicionei às minhas sessões, 23 não foram usadas nenhuma vez em cinco semanas, e 21 delas vinham de plugins. Mesmo assim, todas vão junto no catálogo de toda requisição.

E tem o lixo que fica pra trás. O fluxo de subagentes do superpowers grava briefs e relatórios numa pasta .superpowers/ que o git ignora e ninguém limpa. Numa feature nova, essa pasta ainda tinha os relatórios de uma feature já entregue. O meu agente de Spring Boot achou aquilo, percebeu que não batia com o histórico do git, e gravou sozinho uma memória dizendo pra si mesmo, em resumo: “não confie nesse diretório, confie no git”.

Ou seja, o plugin criou um estado que o meu agente precisou aprender a ignorar.

Então eu não devo usar? Depende.

Já falei aqui antes que dev é pago pra dizer “depende”. Então:

  • Se você tá começando com agentes, um plugin de processo te dá um ponto de partida decente. Muito melhor que nada.
  • Se você quer ideias, leia skills. O verification-before-completion do superpowers é basicamente a regra que eu tenho no meu CLAUDE.md de não dizer que os testes passaram sem mostrar o output. Copie a ideia e adapte pro seu contexto.
  • Se a skill só roda quando você chama, ótimo. O grilling do Matt Pocock, que te enche de perguntas até o plano fazer sentido, é ótimo quando eu peço. Ferramenta é isso.

O problema começa quando o plugin decide sozinho quando entrar em ação e quer ditar o seu fluxo. Aí ele deixou de ser ferramenta e virou teu chefe.

Como montar o seu

Eu não segui nenhum framework. O setup foi crescendo a partir da fricção:

  1. Digitei o mesmo comando duas vezes? Vira script. E vale pro agente também: o meu CLAUDE.md diz que, se ele digitar o mesmo comando duas vezes numa sessão, é hora de virar script.
  2. Expliquei a mesma coisa pro agente duas vezes? Vira regra no CLAUDE.md do repo.
  3. Corrigi o agente? Vira memória, com o porquê junto.
  4. Um fluxo tem mais de três passos e se repete toda semana? Vira skill ou comando.
  5. O repo tem convenções densas? Ganha um agente próprio, que lê as regras daquele repo antes de mexer.

Comece pequeno: um CLAUDE.md que diga o que é cada repo e pra qual branch vai o PR de cada um, e um hook bloqueando o .env. O que é regra de cada repo fica no CLAUDE.md daquele repo. O resto aparece sozinho.

Conclusão

Não vou te prometer que isso deixa você 100x mais produtivo. Deixo essa pros vendedores de curso. O que eu posso dizer é que o setup que funciona pra mim é o meu jeito de trabalhar transformado em código, e não um jeito novo de trabalhar que alguém empacotou num plugin.

Ferramenta boa se adapta a você. Quando é você que tá se adaptando à ferramenta, vale parar e se perguntar quem tá trabalhando pra quem.

Você não precisa de superpoderes. Precisa de contexto, e isso você já tem: são os seus anos de projeto. O navio é seu. Não entregue o leme de bandeja. Até mais!