Kiro da AWS: guia completo do IDE agêntico que pensa antes de codar

Table of contents

Introdução

Se você já usou ferramentas como Cursor ou GitHub Copilot, sabe que são ótimas para gerar código rápido — mas frequentemente falham em features complexas. Falta contexto, decisões arquiteturais ficam implícitas, e é difícil rastrear “por que” aquele código foi escrito daquele jeito.

Kiro é a resposta da AWS para isso. Lançado em preview público em julho de 2025, é um IDE agêntico construído sobre Code OSS (a mesma base do VS Code) que inverte a lógica do desenvolvimento assistido por IA: em vez de gerar código direto do prompt, ele primeiro transforma sua ideia em especificações formais, designs técnicos e planos de implementação — e só depois escreve código.

Este guia cobre tudo que você precisa saber: os 4 pilares do Kiro (Specs, Hooks, Steering, MCP), exemplos práticos, boas práticas, armadilhas comuns, planos de preços e comparações com as alternativas do mercado.

O que é o Kiro

Kiro é um ambiente de desenvolvimento integrado (IDE) que funciona como parceiro estruturado de desenvolvimento. A grande diferença para outras ferramentas de IA é que ele não é apenas um assistente de código — é um agente que formaliza o processo de desenvolvimento.

Os 4 pilares fundamentais:

• Specs: transforma prompts em requisitos, design e tarefas rastreáveis
• Agent Hooks: automações disparadas por eventos (salvar arquivo, criar, deletar, etc.)
• Steering: conhecimento persistente sobre seu projeto, convenções e padrões
• MCP: conecta a docs, APIs e bancos de dados via Model Context Protocol

Instalação e primeiros passos

Kiro está disponível para macOS, Linux e Windows. Como é baseado em Code OSS, se sua máquina roda VS Code, roda Kiro.

Passo a passo:

1. Acesse kiro.dev/downloads e baixe o instalador
2. Execute o instalador como qualquer outro aplicativo desktop
3. No primeiro acesso, escolha entre Google, GitHub, Builder ID ou AWS IAM Identity Center
4. Opcionalmente, importe seus temas, extensões e preferências do VS Code

Se preferir linha de comando (útil em SSH e CI/CD):

curl -fsSL https://cli.kiro.dev/install | bash

Vibe Mode vs Spec Mode

O chat do Kiro tem dois modos de operação que definem como você trabalha com ele:

"Crie um endpoint Express que retorna
uma lista de produtos mockados"

"Implemente um sistema de autenticação multi-tenant
com JWT, refresh tokens e rate limiting por usuário"

Pilar 1: Specs — o coração do Kiro

Specs são o que diferencia o Kiro de todo o resto. Toda especificação gera três arquivos que ficam versionados junto com seu código:

Notação EARS — Easy Approach to Requirements Syntax

O arquivo requirements.md usa EARS, um padrão que força clareza e testabilidade:

WHEN [condição ou evento]
THE SYSTEM SHALL [comportamento esperado]

Exemplos reais:

WHEN um usuário envia um formulário com dados inválidos
THE SYSTEM SHALL exibir erros de validação ao lado dos campos

WHEN o token JWT expirou
THE SYSTEM SHALL retornar 401 e limpar o refresh token do cliente

WHEN o usuário tenta fazer upload de arquivo maior que 10MB
THE SYSTEM SHALL rejeitar com erro 413 e mensagem "Arquivo muito grande"

Os dois tipos de Spec

Boas práticas com Specs

• Commite as specs no Git junto com o código. Elas são documentação viva.
• Revise requirements antes de ir para design — é mais barato corrigir cedo.
• Mantenha specs pequenas e focadas. Uma spec = uma feature. Se ficar gigante, quebre em várias.
• Use Bugfix Specs para qualquer bug em produção — a documentação do “o que NÃO mudar” é ouro.
• Não pule o design.md — mesmo em features pequenas, 5 minutos pensando em arquitetura economizam horas.

Pilar 2: Agent Hooks — automações inteligentes

Um Agent Hook é a combinação de dois elementos: um evento gatilho e uma ação a ser executada. Quando o evento acontece, o Kiro executa automaticamente a ação em background — seja um prompt para o agente ou um comando shell.

Os 10 tipos de trigger disponíveis

Exemplo real: auto-documentação

Título: "Atualizar docs ao salvar rota"
Evento: File Save
Padrão: "src/routes/**/*.ts"
Ação: Ask Kiro
Prompt: |
  Analise a rota modificada e atualize o arquivo
  docs/api.md com a nova especificação OpenAPI.
  Preserve documentação de outras rotas.

Exemplo real: qualidade automatizada

Título: "Rodar testes após tarefa de spec"
Evento: Post Task Execution
Ação: Run Command
Comando: "npm test -- --changed"

Pilar 3: Steering — memória persistente do projeto

Steering files são arquivos Markdown que dão ao Kiro conhecimento contínuo sobre seu workspace. Em vez de repetir suas convenções em cada prompt, você escreve uma vez e o Kiro lembra para sempre.

Os 3 arquivos fundacionais

Kiro oferece gerar automaticamente três arquivos base, recomendados para todo projeto:

• product.md — Propósito, usuários-alvo, features principais, objetivos de negócio
• tech.md — Frameworks, bibliotecas, ferramentas e restrições técnicas
• structure.md — Organização de arquivos, nomenclatura, padrões arquiteturais

Os 4 modos de inclusão

Nem todo contexto precisa estar sempre ativo. Kiro oferece 4 modos configuráveis via front-matter YAML:

---
inclusion: always
---

---
inclusion: fileMatch
fileMatchPattern: ["**/*.ts", "**/*.tsx"]
---

---
inclusion: manual
---

---
inclusion: auto
name: api-design
description: REST API design patterns. Use when creating or modifying API endpoints.
---

Pilar 4: MCP Servers — plugins agênticos

Model Context Protocol (MCP) é um protocolo aberto (criado pela Anthropic) que permite que agentes de IA se conectem a servidores externos especializados. Pense em MCP como extensões: cada servidor adiciona ferramentas, prompts e recursos específicos a um domínio.

Com MCP conectado, o Kiro pode:

• Acessar documentação especializada (ex: AWS Docs MCP)
• Consultar bancos de dados (Postgres, MongoDB)
• Integrar com APIs externas (GitHub, Jira, Linear)
• Executar ferramentas customizadas do seu workflow

Exemplo de configuração

{
  "mcpServers": {
    "aws-docs": {
      "command": "uvx",
      "args": ["awslabs.aws-documentation-mcp-server@latest"]
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "POSTGRES_URL": "postgresql://user:pass@localhost/db"
      }
    }
  }
}

Planos e preços

Kiro trabalha com modelo de créditos — cada prompt consome uma fração de crédito, dependendo da complexidade e do modelo.

Um crédito é uma unidade de trabalho em resposta a um prompt, medido com duas casas decimais (mínimo 0,01). Prompts simples consomem menos de 1 crédito; execução de spec task tipicamente consome mais. Modelo Auto é base (1x), Sonnet 4 custa ~1,3x mais, Opus ainda mais.

Kiro vs Cursor vs GitHub Copilot

Resumo prático:

• Escolha Kiro se constrói features complexas, trabalha em time, precisa de documentação/auditoria, ou valoriza estrutura
• Escolha Cursor se quer a melhor experiência de autocomplete inline e workflow menos estruturado
• Escolha Copilot se está no ecossistema GitHub/Microsoft e quer um plugin leve

Não é exclusivo — muitos devs usam Copilot para autocomplete + Kiro para features estruturadas.

Armadilhas comuns (o que evitar)

Trilha de aprendizado em 3 semanas

Semana 1 — Fundação: instale, explore, faça o tutorial oficial. Use só Vibe Mode por uns dias. No final da semana, crie seu primeiro Spec simples.

Semana 2 — Personalização: gere os 3 steering fundacionais para um projeto real. Crie 2-3 steering files específicos com fileMatch. Experimente Agent Hooks começando simples.

Semana 3 — Escala: conecte um MCP server. Use Bugfix Spec em um bug real. Combine tudo em um projeto novo e compare produtividade.

Conclusão

Kiro representa uma proposta diferente no mercado de IDEs agênticos: em vez de otimizar para velocidade de escrita de código, ele otimiza para qualidade e rastreabilidade através de spec-driven development. Isso tem custo cognitivo — pensar em requirements antes de codar é uma mudança de hábito — mas paga dividendos em features complexas, trabalho em equipe e código que precisa durar.

Se você já está confortável com Cursor ou Copilot, considere adicionar o Kiro ao seu arsenal para projetos estruturados. Os pilares de Specs, Hooks, Steering e MCP se complementam de forma que, uma vez configurados, criam um ambiente onde consistência e qualidade viram default automático.

Recursos oficiais

• Site oficial: kiro.dev
• Documentação: kiro.dev/docs
• Blog: kiro.dev/blog
• FAQ: kiro.dev/faq
• MCP oficial: modelcontextprotocol.io
• AGENTS.md padrão: agents.md

Gostou deste guia? Assine a newsletter para receber novos posts sobre IA agêntica, ferramentas de desenvolvimento e engenharia moderna.