Como Parar de Arrastar Caixas no Draw.io Usando Kiro CLI e MCP

Se você é um desenvolvedor Java, arquiteto de soluções ou qualquer pessoa que já perdeu uma tarde no draw.io — este é para você.

Fazendo parte de 5 equipes de engenharia ao longo de 8 anos, aqui está algo que experimentei em quase todas as equipes de engenharia das quais fiz parte. E você deve ter passado por isso também.

O gerente de produto entrega um PRD. Nos reunimos em salas de reunião como desenvolvedores com marcadores de quadro branco voando, discussões de design esquentando, alguém esboçando um sistema na parede de vidro que realmente faz sentido.

E então vem a parte que todos temiam.

"Ok, agora crie um documento de design e adicione os diagramas."

Documentos de design. Diagramas de sequência. Diagramas de classe. Diagramas de arquitetura. Tudo isso — formalizado, controlado por versão e meticulosamente criado no draw.io.

Eu realmente odiava isso.

E eu acho que você sabe exatamente o que quero dizer. Arrastando caixas. Alinhando setas. Ajustando à grade. Desajustando da grade porque se ajustou à coisa errada. Gastando 30 minutos em algo ou talvez mais. Parecia a versão menos produtiva e a parte não glamourosa do trabalho de engenharia e, ainda assim, de alguma forma, sempre bloqueava a revisão de design.

Honestamente? Eu teria ficado feliz em apenas tirar uma foto do esboço no quadro branco e considerar feito. Se apenas alguém pudesse entender isso magicamente. Ou se eu pudesse apenas falar o que queria desenhar e fazê-lo aparecer.

Na verdade, eu não me importava com diagramas de sequência. A lógica era satisfatória. Mapeando o fluxo, vendo as interações, assistindo o sistema contar sua própria história. Eu poderia me envolver com isso.

Mas, novamente, com diagramas de arquitetura da AWS, o problema não eram realmente os ícones.

E aqui está a questão — isso não é apenas um problema "meu".

Se você já foi responsável por diagramas de arquitetura em uma equipe real, você sabe exatamente do que estou falando. A dor é universal. E está bem documentada:

Criar diagramas de arquitetura da AWS profissionais é uma daquelas tarefas que parecem simples e nunca são. Arquitetos de soluções, desenvolvedores, líderes técnicos — todos têm que fazer isso. E todos têm as mesmas reclamações.

Leva uma eternidade. Um diagrama de arquitetura detalhado pode consumir horas. Às vezes dias se você estiver fazendo um design de sistema completo para uma revisão de conformidade ou uma nova proposta de produto.

As ferramentas têm uma curva de aprendizado. draw.io, Lucidchart, Visio — não são difíceis, mas também não são rápidas. E cada nova pessoa na equipe tem que aprendê-las do zero.

A consistência é uma batalha constante. Você faz um diagrama em um estilo, alguém faz outro, e de repente sua documentação parece que foi projetada por três equipes diferentes. Porque foi.

Os ícones da AWS ficam desatualizados. A AWS lança novos serviços, atualiza conjuntos de ícones, renomeia coisas. Manter seus diagramas em sincronia com a linguagem visual oficial da AWS é um trabalho de meio período que ninguém se inscreveu para fazer.

E a manutenção? Toda vez que a arquitetura evolui — e ela sempre evolui — você está de volta na ferramenta, reorganizando caixas, redirecionando setas, esperando que nada quebre o layout.

O resultado é que os diagramas se tornam um gargalo. Ou pior — eles se tornam desatualizados no momento em que são publicados e ninguém os atualiza porque é muito doloroso.

Aqui está o que eu continuo pensando: diagramas de arquitetura existem para comunicar. Esse é o único trabalho deles. Para pegar o sistema na sua cabeça e torná-lo legível para outros humanos.

E ainda assim, as ferramentas que usamos para criá-los atrapalham essa comunicação. O meio se torna o obstáculo.

Então, quando digo que parei de arrastar caixas — quero dizer que encontrei uma maneira de fechar essa lacuna. Para ir de "sistema na minha cabeça" para "diagrama na tela" sem a taxa entre eles.

Deixe-me mostrar como.

O problema era a taxa de pensamento.

Você encontraria o ícone correto do Lambda. Ótimo. Agora arraste-o. Agora conecte-o ao API Gateway. Agora rotule a seta. Agora alguém na revisão diz "você pode adicionar o limite do VPC?" e você gasta 20 minutos reorganizando tudo porque o layout quebra quando você adiciona um contêiner.

E então a AWS lança um novo serviço. Ou renomeia um. Ou o conjunto de ícones é atualizado. E de repente seu diagrama "oficial" parece ligeiramente diferente da arquitetura de referência na documentação da AWS.

Nunca se tratou realmente dos ícones. Tratava-se da lacuna entre o sistema na sua cabeça e o diagrama na tela. Essa lacuna sempre foi larga demais. Muito manual. Muito lenta.

Eu costumava ficar lá pensando — e se eu pudesse apenas dizer o que quero desenhar?

Como, literalmente descrever minha arquitetura em voz alta e fazê-la aparecer. Ícones corretos. Agrupamentos adequados. Melhores práticas incorporadas.

Acontece que — isso é exatamente o que é possível agora.

Parei de arrastar caixas. Aqui está o que eu faço em vez disso.

Parte 1: Diagramas oficiais da AWS com Kiro CLI + MCP

Antes de entrarmos na configuração, deixe-me explicar rapidamente o que realmente está acontecendo por trás das cortinas — porque entender isso faz tudo se encaixar.

Kiro CLI é uma interface de linha de comando que traz capacidades de IA generativa diretamente para o seu terminal. Você interage com ele através de prompts em linguagem natural.

MCP (Modelo de Contexto de Protocolo) — desenvolvido pela Anthropic como um protocolo aberto — fornece uma maneira padronizada de conectar modelos de IA a praticamente qualquer fonte de dados ou ferramenta. Pense nisso como um sistema de plugins para IA. Servidores MCP atuam como extensões especializadas que dão ao Kiro capacidades específicas de domínio que ele não teria por conta própria.

Os dois servidores MCP que estamos usando:

• AWS Diagram MCP → gera diagramas usando o pacote Python diagrams com o conjunto completo de ícones oficiais da AWS
• AWS Documentation MCP → pesquisa e lê a documentação da AWS para validar as melhores práticas antes de gerar

Juntos, eles dão ao Kiro a capacidade de produzir diagramas de arquitetura que são tanto visualmente corretos QUANTO arquitetonicamente sólidos.

Configuração (5 minutos, uma vez)

Passo 1: Instalar Kiro CLI

Baixe e instale a partir da documentação oficial, depois verifique:

kiro-cli --version
# kiro-cli x.x.x

Faça login com suas credenciais da AWS:

kiro-cli login
# Recomendado: use AWS Builder ID para experimentar

Passo 2: Instalar dependências

pip install uv
uv python install 3.10
# Também instale o GraphViz para seu SO

Passo 3: Configurar servidores MCP

Adicione isso a ~/.kiro/settings/mcp.json:

{
  "mcpServers": {
    "awslabs.aws-diagram-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.aws-diagram-mcp-server"],
      "env": { "FASTMCP_LOG_LEVEL":