Com IA, a distância entre desenhar e construir está ficando cada vez menor. Mexer no repositório, transformar um fluxo do Figma em código para testar uma ideia, corrigir um detalhe de tela sem esperar a próxima sprint: coisas que antes ficavam com o time de desenvolvimento estão entrando na rotina dos designers. Eu senti esse empurrão do mercado também.
Só que um bom prompt exige transformar a ideia que está na sua cabeça em instruções claras. E, mesmo quando o pedido sai bem escrito, a resposta nem sempre é. Quais arquivos o Claude adicionou, removeu ou modificou? Como isso impacta o projeto? E os créditos: toda tarefa precisa mesmo do modelo mais caro?
Eu não tinha essas respostas. O Claude até conta o que está fazendo, no terminal e na conversa, mas eu via as mudanças acontecendo sem entender o que significavam.
O agent-crew nasceu desse incômodo. É um plugin open source para o Claude Code (VS Code, Cursor, JetBrains ou terminal) que cuida das duas pontas: começa entendendo direito o que você quer construir e termina explicando o que foi feito, respeitando o seu nível de experiência. No meio, cada etapa usa o modelo certo para a tarefa. Neste artigo eu conto como a ideia surgiu, como ela evoluiu e o passo a passo para você testar.
Como funciona a pipeline
A ideia veio ao ler como outras pessoas trabalhavam com agentes. Em vez de um pedido solto, elas pediam a execução de um plano, em etapas, cada uma com um agente. Testei esse formato nos meus projetos e montei a minha própria equipe de agentes, organizada como um time de produto.
A minha dor era não entender o que estava acontecendo. Eu pedia uma mudança, o Claude fazia, e eu ficava com um código que funcionava, mas que eu não sabia explicar. Revisar era impossível. E, se algo quebrasse depois, eu não saberia por onde começar.
Então o agent-crew começa mostrando o plano e só constrói depois que você aprova. Enquanto trabalha, cada etapa aparece no painel, e você sabe em que ponto o card está. No fim, entra o mentor, que era o que mais me faltava. O Claude já conta o que fez, mas na linguagem de quem programa. O mentor traduz quais arquivos mudaram, como e por quê, respeitando o seu nível de conhecimento.
Com esse contexto, cada card me ensina um pouco de desenvolvimento. Se você já é dev, o mesmo contexto serve para acompanhar as mudanças sem precisar ler tudo.
Cada pedido vira um card, que passa por oito etapas.
Por que usar modelos diferentes?
O Claude tem três famílias de modelos.
- O Opus é o que raciocina melhor, mas é o mais lento e o mais caro.
- O Sonnet equilibra qualidade e custo.
- O Haiku é o mais rápido e o mais barato.
Usar o Opus em tudo seria como chamar a pessoa mais sênior do time para tirar print de tela. Por isso ele fica nas etapas em que um erro custa caro, como entender o pedido, planejar e revisar. Se uma delas falhar, todo o resto sai errado. O Sonnet constrói e explica, seguindo o plano que o Opus criou e você aprovou. O Haiku cuida das tarefas bem definidas, como ler o código, rodar os testes e escrever a descrição do pull request. Se um modelo não estiver disponível, o kit troca por um reserva e avisa no painel.
Conversa também se desenha
Quase tudo no agent-crew acontece numa conversa. Por isso foi ali que passei mais tempo desenhando.
Tudo começa com um setup rápido, feito uma vez por projeto. O objetivo é deixar o kit saber com quem está falando, para adaptar as explicações, os exemplos e o código. Ele faz perguntas como idioma de preferência, nível de conhecimento em desenvolvimento com IA, área de atuação e o tipo de projeto. Qualquer pergunta pode ser pulada e ajustada depois, com comandos como /agent-crew:set-level.
O sistema de design que deve ser utilizado no projeto também entra no setup. Pode vir do Figma, de uma biblioteca pronta ou do que já existe no código. Se não tiver nenhum, o kit monta um tema simples a partir das respostas a quatro perguntas.
Depois do setup, vem a parte que resolve a dor do prompt. Enquanto a ideia não está 100% clara, o agent-crew não começa a construir o código. Antes de planejar, ele lista o que ficou em aberto no pedido e pergunta. Com as respostas, transforma a ideia que estava na sua cabeça em um plano que faz sentido, e é esse plano que guia todos os outros agentes.
Como testar?
Use o Claude Code onde preferir, seja no app do Claude, na sua IDE ou no terminal. Não é necessário ter uma conta no GitHub para usar.
Para instalar, siga os passos:
Instale. Abra o Claude Code no ambiente escolhido e cole:
Instale o agent-crew para mim. No terminal, rode: claude plugin install agent-crew --marketplace akacaja/agent-crew Se esse comando não funcionar, rode antes "claude plugin marketplace add akacaja/agent-crew" e depois "claude plugin install agent-crew@agent-crew". No fim, me diga se deu certo e o que eu preciso fazer para os comandos aparecerem.O painel da pipeline vem junto.
Abra uma pasta vazia. Crie uma pasta só para o teste e abra o Claude Code nela, por exemplo
ola-teste.Prepare o projeto. Digite
/agent-crew:start. O kit pergunta o idioma, depois o seu nível, a sua área, o tipo de projeto e o sistema de design. Pode pular qualquer pergunta.Rode o primeiro card. Descreva a tarefa depois do comando:
/agent-crew:card Quero uma página de lista de espera para um app de receitas. Ela precisa de um título, uma frase curta sobre o app, um campo de e-mail e um botão "Quero entrar". Use o tema do projeto e deixe funcionando bem no celular.Responda e aprove. O planner vai fazer perguntas e depois mostrar o plano. Quando o painel disser "Aguardando você", é a sua vez.
Leia o mentor e veja o resultado. No fim, ele explica o que foi feito e diz o que fazer agora. Para ver a página funcionando, peça:
Rode o projeto localmente e me diga como abrir no navegador.
Comandos que vale conhecer
| Comando | Para que serve |
|---|---|
/agent-crew:card | Começa uma tarefa nova |
/agent-crew:mentor | Pede uma explicação sobre o que está acontecendo |
/agent-crew:pause e /agent-crew:resume | Salva o card para continuar outro dia |
/agent-crew:profile | Mostra as suas configurações e como mudar cada uma |
/agent-crew:set-level | Muda o nível das explicações (e há set-language, set-area, set-project, set-design) |
/crew-panel | Abre o painel da pipeline |
/crew-feedback | Manda a sua opinião sobre o kit |
Próximos passos
O agent-crew está na versão 0.9.6, e a ideia é que ele evolua a partir do uso de verdade. Cada feedback e cada necessidade que aparecer pode virar um ajuste ou uma funcionalidade nova. Por isso, se você testar, me conta como foi.
No próprio Claude Code, digite /crew-feedback para escrever um comentário, sem precisar de uma conta no GitHub. Ou, se preferir, abra uma issue no repositório explicando onde travou ou o que mais você gostaria que o kit fizesse.