AWS Builder Center
O que é o Kiro Crew e quando usar versus a IDE, CLI e Web

O que é o Kiro Crew e quando usar versus a IDE, CLI e Web

Kiro IDE, CLI, Web e agora Crew: com tanta versão do Kiro, qual usar? Neste artigo, vamos entender o que é o Kiro Crew, conhecer suas principais funcionalidades, como sessões, agendamentos, artefatos, apps e crewmates, e ver como o gateway permite manter seus agentes rodando mesmo com o seu computador desligado. No final, te trago uma árvore de decisão pra você saber quando delegar pro Crew e quando dirigir pela IDE, CLI ou Web.

Developer Advocate @ AWS
Desde que o  Kiro Crew  foi lançado, tem uma pergunta que eu ando escutando muito: "Com tanta versão do Kiro, IDE, CLI, Web e agora o Crew, qual delas eu devo usar?".

Eu entendo a confusão, já me fiz a mesma pergunta. Mas depois de brincar bastante com todas elas, cheguei na conclusão talvez contraintuitiva de que, na verdade, essa é a pergunta errada. Não existe uma versão do Kiro "melhor" que a outra, porque todas usam o mesmo motor por baixo dos panos. A pergunta certa tem mais a ver com o jeito que você quer trabalhar do que com a ferramenta em si.

Neste artigo eu vou te mostrar o que é o Kiro Crew, o que ele faz e, principalmente, te dar uma árvore de decisão, pra você nunca mais ter dúvida de qual versão do Kiro usar.


Várias ferramentas, mesmo motor

Antes de mais nada, vale entender que por trás dos panos, a IDE, a CLI, a Web e o Crew usam o mesmo motor, o assistente de IA Kiro. Chamamos esse "motor" de  Kiro Harness . Ele equivale, mais genericamente, ao conceito de agent harness, que é a camada de um agente que conversa com o modelo, executa as ferramentas e mantém o contexto das sessões. O que muda de uma ferramenta do Kiro pra outra não é a inteligência nem a capacidade do assistente, mas sim a interface de acesso e as funcionalidades de cada uma.

Pensa no Kiro como o motor de um carro e em cada versão como um modelo diferente montado em cima dele. O motor é o mesmo, mas um modelo é feito pra cidade, outro pra estrada, outro pra carga. É por isso que perguntar "qual versão é a melhor" não leva a lugar nenhum. A pergunta boa é "qual delas combina com o que eu preciso fazer agora".

Para responder isso, primeiro a gente precisa conhecer o membro mais novo da família...


O que é o Kiro Crew

O Kiro Crew é um ambiente de desenvolvimento de código aberto que deixa você orquestrar vários agentes pra darem conta de tarefas diferentes ao mesmo tempo. Ele roda tarefas agendadas e recorrentes, conecta e coordena ferramentas externas, monitora métricas, invoca vários agentes pra trabalhos distintos e por aí vai.

Mas se eu tivesse que resumir o que realmente separa o Crew das outras versões, seriam três coisas:
  • Memória persistente: ele guarda o seu contexto entre sessões e aprende como você trabalha, transformando suas correções em conhecimento. Assim, você não precisa repetir o contexto do projeto ou as suas preferências toda vez que vai fazer alguma coisa;
  • Autonomia não supervisionada: ele toca tarefas sozinho de ponta a ponta, mesmo sem você estar ali o tempo todo acompanhando cada passo;
  • Delegação: em vez de um agente só fazendo tudo, ele distribui o trabalho entre vários agentes trabalhando em paralelo.

Por padrão, o Kiro Crew roda na sua máquina, então ela precisa estar ligada para que as tarefas sejam executadas, mas existem também formas de rodar elas em um host externo. Vamos entender mais sobre isso na seção sobre Kiro Crew gateway desse artigo.


O Crew na prática

Na barra lateral da interface do Kiro Crew, você verá algumas funcionalidades principais. Vamos passar por cada uma delas.


Sessões no Kiro Crew

É aqui que você conversa com o Kiro. Cada sessão é uma conversa com um agente trabalhando numa tarefa, e você pode ter várias rodando ao mesmo tempo, até mesmo falando com diferentes agentes. Caso você feche a janela do Kiro Crew, essas sessões não se perdem e você pode continuar de onde parou depois. À medida que você vai conversando com o Kiro, pelas sessões, ele vai se lembrando do seu contexto e preferências, então melhora a forma de trabalhar com o tempo.

Feature de sessões no app desktop do Kiro Crew



Agendamentos no Kiro Crew

Com os agendamentos você pode programar um agente pra rodar uma tarefa num horário específico ou de forma recorrente. Você pode se basear nos agendamentos já oferecidos pelo Kiro Crew ou criar seus próprios. Ao criar, você define o prompt que vai acionar seus agentes a cada uso e com que frequência o job deve rodar. Por exemplo, você pode criar um agendamento que todo dia às 9h monta um resumo das suas tarefas, commits, pull requests e impedimentos pra você levar pronto pra daily do time.

Outra coisa legal é que você pode escolher o agente ou o modelo que deve rodar esse job agendado. Assim, você consegue ainda escolher modelos mais leves e baratos pra algo simples e repetitivo como esse resumo da daily, e um modelo mais capaz (e mais caro) só quando a tarefa agendada for mais complexa.

Feature de agendamentos no app desktop do Kiro Crew



Artefatos no Kiro Crew

Aqui ficam guardados todos os artefatos que os agentes produzem durante as tarefas como relatórios, trechos de código, análises, documentos, etc. Essa feature te ajuda a ter um lugar centralizado para os artefatos produzidos entre várias sessões e te permite revisar, editar e salvar sem precisar ficar procurando no meio das conversas. Eu, por exemplo, usei o Kiro Crew para entender a arquitetura de um sistema e criar alguns diagramas e eles ficaram salvos automaticamente como artefatos para mim.

Feature de artefatos no app desktop do Kiro Crew



Apps no Kiro Crew

Os apps são interfaces que empacotam integrações com ferramentas, agentes e skills numa UI feita pra uma tarefa específica. Você pode criar e importar o seu próprio app ou usar um dos que já vêm com o Kiro Crew. Por exemplo, o app Design Critique oferecido pelo Kiro Crew permite que você faça upload de uma tela de UI e o Kiro fará uma avaliação, citando o que está funcionando e os pontos que valem um ajuste, cada um ligado a uma heurística nomeada. Na imagem abaixo, por exemplo, veja como ele analisou o design da minha página de portfólio pessoal.

App de Design Critique no Kiro Crew



Personalização de agentes e Crewmates no Kiro Crew

É aqui que você molda como os seus agentes se comportam, definindo agentes personalizados. Eles funcionam como templates de agentes e incluem o modelo usado por aquele tipo de agente, o prompt que guia seu funcionamento, suas ferramentas, habilidades (ou skills), recursos e servidores MCP. Você então aplica esse modelo de agente personalizado aos crewmates. Da mesma forma que falei sobre os agendamentos, recomendo escolher o modelo baseado na complexidade da tarefa, usando modelos mais leves e baratos para tarefas simples e mais poderosos e caros para agentes que administrarão trabalhos mais complexos de raciocínio.

Observação importante: Na interface do Kiro Crew em português, "Crewmates" é traduzido como "colegas", mas eu não gosto dessa tradução então vou continuar chamando de crewmates 😜

Um crewmate é um agente nomeado que usa as definições de agente personalizado que você criar, carregando memória própria. Ao criar um crewmate, você define o template de agente personalizado, o espaço de trabalho da sua máquina onde ele pode trabalhar e os triggers, ou seja, em que situação o Kiro Crew deve passar uma tarefa para esse agente. Você também pode abrir uma sessão no Kiro Crew para falar diretamente com o agente definido.

O mais importante de se entender é que cada crewmate tem memória persistente própria. Isso é importante porque melhora os resultados do agente com o tempo, já que ele vai melhorando com as correções do usuário. Ao mesmo tempo, ele concentra o conhecimento do domínio pelo qual é responsável, ficando especialista nele em vez de se distrair equilibrando vários contextos diferentes.

Compartilhando um exemplo próprio, esses dias estava escrevendo um documento de design usando só o agente default que já vem com o Kiro Crew. Em uma sessão estava definindo a arquitetura da solução, em outra estava tirando dúvidas sobre o estado atual do sistema e em uma terceira resolvi pedir que o Kiro criasse um diagrama da solução. Ele criou e, honestamente, o resultado não ficou ruim, mas tinha alguns problemas de posicionamento que estavam me incomodando...

Diagrama de design criado com agente default


Foi então que lembrei que eu tinha uma skill para geração de animações que poderia ter instruções úteis para ajudar o Kiro a ser mais preciso na geração de diagramas. Usei essa skill como base para criar uma skill mais específica de geração de diagramas que chamei de static-diagrams. Também construí um steering file (equivalente a arquivos de rules/custom instructions no Kiro) com minhas preferências estéticas para os diagramas. Então adicionei essa skill e instruções a um agente personalizado e criei um crewmate a partir dele. Por último, pedi que o crewmate criasse um novo diagrama para mim e dessa vez tive esse resultado:

Diagrama de design criado por um agente personalizado


Veja abaixo também como se parece a configuração do meu agente personalizado no Kiro Crew:

Agente personalizado no app desktop do Kiro Crew



Kiro Crew Gateway: como funciona por trás dos panos

 Kiro Crew gateway  (ou gateway do Kiro Crew) é o processo backend por trás do Kiro Crew. A interface que você usa, seja o app desktop do Kiro Crew, a interface web ou a CLI, é só uma janela que se conecta a esse gateway.

Por padrão, ele roda na sua própria máquina. Isso significa que sessões, agendamentos e tarefas autônomas só funcionam enquanto o seu computador está ligado e com o Kiro Crew rodando. Se você não abrir o notebook, aquele agendamento para a daily das 9h não vai acontecer. Mas como a interface e o gateway são coisas separadas, nada te impede de rodar o gateway em outro lugar.


Rodando o gateway em um host remoto

Se você quer que as tarefas continuem rodando com o seu computador desligado, pode fazer o deploy do gateway em um host remoto que você mesmo controla, como uma instância Amazon EC2, uma VPS ou um servidor em casa. O app no seu notebook passa a se conectar a esse gateway remoto, e os agendamentos, tarefas e integrações continuam funcionando mesmo com o notebook fechado.

Algumas coisas que vale saber antes:
  • Você é responsável pelo host. O Kiro Crew é de código aberto e roda no seu hardware, então custo, atualização e segurança da máquina remota ficam com você;
  • O gateway não fica exposto na internet. Ele só escuta em loopback, e você acessa por um túnel SSH ou pelo AWS Systems Manager Session Manager;
  • O Kiro CLI precisa estar instalado e logado no host remoto, porque é por ele que o gateway conversa com o modelo.

O passo a passo completo está na página  Running 24/7  da documentação.


A árvore de decisão: dirigir ou delegar?

Agora que você já sabe o que o Crew faz, voltamos à pergunta do começo: quando usar Kiro Crew vs a IDE, CLI e versão Web.

Eu gosto de pensar que a IDE, a CLI e a Web são o seu lugar quando você está dirigindo o trabalho em tempo real, principalmente para tarefas pontuais ou que façam parte de um contexto isolado. Já o Kiro Crew brilha quando o foco é delegar em vez de dirigir, ou seja, quando você quer uma frota de agentes rodando sozinha enquanto você faz outra coisa. Além disso, Kiro Crew ganha quando sua tarefa pode se beneficiar de conhecimento acumulado entre várias sessões de trabalho, já que conta com memória persistente.

Pra decidir na prática, faça estas quatro perguntas:
Árvore de decisão contendo 4 critérios de quando usar o Kiro Crew


Qualquer "sim" para essas perguntas é um sinal a favor do Crew. Se a sua resposta pra quase todas foi "não", talvez a tarefa seja pontual e você queira estar ali no volante, decidindo a cada passo, então o seu lugar é a IDE, a CLI ou a Web. A escolha entre essas três é sobre onde você se sente mais confortável: a IDE quando está escrevendo ou revisando código no editor, a CLI quando está trabalhando no terminal, e a Web quando quer guiar sessões de qualquer lugar por um painel só.

Em exemplos mais concretos e pessoais, se eu vou planejar uma aplicação que quero construir ou escrever um design de uma funcionalidade ou uma automação, uso Kiro Crew. Por outro lado, se estou desenvolvendo uma feature e revisando o código dela, prefiro usar a IDE. Agora, se já estou com o terminal aberto, commitando mudanças e quero ajuda para arrumar a árvore de commits que quebrei (é raro, mas acontece muito), provavelmente vou abrir uma sessão do Kiro CLI e resolver rapidinho na hora. Por último, se estou só com o celular na mão e recebo uma mensagem da minha gestora pedindo para eu marcar uma reunião às 2 horas da tarde do México, talvez abra o Kiro na versão Web para perguntar que horas isso corresponde no Brasil.


Conclusão

Agora você já sabe o que é o Kiro Crew e, mais importante, quando faz sentido usar ele no lugar da IDE, da CLI ou da Web. No fim do dia não existe uma versão melhor que a outra. Todas usam o mesmo motor. O que muda é como você quer trabalhar e quais funcionalidades mais vão te ajudar naquele momento.

Da próxima vez que bater aquela dúvida de "qual Kiro usar", passa a tarefa pela árvore de decisão e deixa a resposta aparecer sozinha. E pra fechar, me contem, quem aí já está usando o Kiro Crew e o que construíram com ele? Se ainda não testou, mas deu curiosidade, siga os  passos de instalação  e teste você mesmo!
Any opinions in this article are those of the individual author and may not reflect the opinions of AWS.
Enjoyed reading this content? Let the author know!

Your likes, comments, shares, and saves help creators reach more builders.

Loading recommendations

Loading article