Artigo 5 de 12
Kiro & AWS

Kiro para o time de negócio: como PO, produto e stakeholders finalmente veem o que pediram virar o que foi feito

A maior dor do software nunca foi escrever código. É a distância entre "o que eu pedi" e "o que foi entregue" — e o Kiro ataca exatamente esse vão.

12 de julho de 2026 · Prompt & Deploy

TL;DR

  • A dor central de todo projeto de software é a tradução: o que o negócio pede em uma frase vira, semanas depois, algo diferente do que estava na cabeça de quem pediu.
  • O Kiro transforma um pedido vago em um requirements.md legível — user stories mais critérios de aceitação em notação EARS, que qualquer pessoa de produto consegue ler e aprovar.
  • Approval gates: requisitos e design são validados antes de qualquer linha de código. Você corrige no parágrafo, não no deploy.
  • Rastreabilidade: cada tarefa técnica aponta para o requisito que a originou. A pergunta “cobrimos tudo?” ganha uma resposta verificável.
  • Isso conversa direto com o AI-DLC (AI-Driven Development Life Cycle) da AWS, onde o time valida junto as perguntas da IA numa sessão de Mob Elaboration.

A dor que ninguém coloca no roadmap

Todo mundo que trabalha com produto conhece esta cena. Você descreve uma funcionalidade numa reunião de 40 minutos. O time balança a cabeça. Três semanas depois, a demo acontece — e o que aparece na tela não é o que você tinha imaginado. Não porque alguém foi incompetente, mas porque a sua frase passou por cinco cabeças, dois documentos, um chat e um monte de suposições silenciosas no caminho.

Essa é a maior dor do desenvolvimento de software. Não é a complexidade técnica. Não é a estimativa. É a distância entre a intenção e a entrega — o telefone-sem-fio que separa “o que eu pedi” de “o que foi feito”. Cada elo dessa corrente perde um pouco de contexto, e ninguém percebe até ser tarde e caro.

O reflexo tradicional é escrever mais documentação, marcar mais reuniões de alinhamento, criar mais campos no Jira. Nada disso resolve o problema de raiz, porque o documento vive fora do trabalho. Ele envelhece no dia em que o código começa a mudar. O que o Kiro propõe é diferente: colocar a intenção dentro do repositório, num formato que o negócio lê e aprova, e que o time técnico executa e mantém sincronizado. É o que ele chama de spec-driven development — e é aí que quem trabalha com produto ganha um assento à mesa que antes não existia.

A documentação tradicional descreve o que o software deveria fazer. A spec do Kiro é a instrução do que ele vai fazer.

Da intenção vaga ao requisito claro

Vamos ao caso concreto. Imagine o pedido típico, aquele que cabe numa mensagem de Slack:

ANTES — o pedido, como ele nasce:

“Precisamos deixar os clientes avaliarem os produtos que compraram.”

Uma frase. Parece suficiente. Mas ela esconde uma dúzia de decisões que ninguém tomou ainda: qualquer pessoa pode avaliar, ou só quem comprou? Nota de quantas estrelas? Tem limite de texto? E se alguém escrever um palavrão? O que acontece se um cliente que não comprou tentar avaliar mesmo assim?

No mundo antigo, essas perguntas ou nunca são feitas (e viram bug), ou são feitas tarde demais (e viram retrabalho). No Kiro, elas viram um documento que você lê e aprova antes de qualquer coisa ser construída.

DEPOIS — o requirements.md que o Kiro gera a partir daquela frase:

# Requisitos — Sistema de Avaliações de Produtos

## User Story 1: Criar avaliação
Como cliente autenticado, quero avaliar um produto que comprei,
para ajudar outros compradores.

### Critérios de aceitação (EARS)
- WHEN um cliente autenticado envia uma avaliação com nota de 1 a 5,
  THE SYSTEM SHALL persistir a avaliação e associá-la ao produto e ao usuário.
- IF o usuário não comprou o produto,
  THEN THE SYSTEM SHALL rejeitar a avaliação com HTTP 403.
- WHILE o texto da avaliação exceder 2.000 caracteres,
  THE SYSTEM SHALL bloquear o envio e exibir mensagem de validação.
- WHERE a avaliação contém linguagem sinalizada pelo filtro,
  THE SYSTEM SHALL marcá-la como "pendente de moderação".

Repare no que aconteceu. A frase vaga virou uma user story (“Como cliente… quero… para…”) seguida de quatro regras explícitas. Cada regra que estava implícita na sua cabeça — “só quem comprou”, “nota de 1 a 5”, “não pode ser texto infinito”, “precisa filtrar palavrão” — agora está escrita, preto no branco, para você concordar ou corrigir.

O que é EARS, em linguagem de negócio

Aquelas palavras em maiúsculas — WHEN, IF, WHILE, WHERE, THE SYSTEM SHALL — não são jargão técnico. São o EARS (Easy Approach to Requirements Syntax), uma forma disciplinada de escrever regras sem ambiguidade. Você não precisa decorar nada; basta ler em voz alta:

  • WHEN (quando) algo acontece → o sistema deve reagir de tal forma. É o comportamento normal esperado. “Quando um cliente envia uma avaliação válida, o sistema salva.”
  • IF / THEN (se / então) uma condição de exceção ocorre → o sistema deve tratá-la. “Se o usuário não comprou, então recusa.”
  • WHILE (enquanto) uma situação se mantém → o sistema deve respeitar aquela restrição. “Enquanto o texto passar de 2.000 caracteres, bloqueia.”
  • WHERE (onde / nos casos em que) uma característica está presente → o sistema deve se comportar de modo específico. “Nos casos em que há linguagem sinalizada, marca como pendente.”

A mágica do EARS para quem é de produto é que ele elimina o “depende”. Não existe requisito na moral da história. Cada linha tem um gatilho e uma consequência. Se está escrito, vai ser construído. Se não está, você descobre a lacuna lendo o documento, não na demo.

EARS não é para o desenvolvedor entender o negócio. É para o negócio conseguir auditar o software antes que ele exista.

Validar cedo, não no fim

Aqui está a mudança de jogo para stakeholders. O Kiro estrutura a spec em três fases sequenciais, com portões de aprovação (approval gates) entre elas:

Requisitos → Design → Tarefas.

Você — PO, product manager, stakeholder — aprova a fase de requisitos antes de o Kiro sequer pensar em arquitetura. Depois, ele produz o design (como o sistema vai funcionar por dentro: fluxos, modelo de dados, tratamento de erros) e pede sua validação de novo, agora com o time técnico. Só depois dessas duas aprovações é que ele quebra tudo em tarefas e começa a implementar.

Compare os dois mundos:

Modelo tradicionalCom approval gates do Kiro
Quando o negócio vê o resultadoNa demo, semanas depoisNo documento, no dia 1
Custo de corrigir um mal-entendidoAlto (código já escrito)Baixo (é editar um parágrafo)
O que se aprovaUma promessa verbalUm artefato versionado
Quem detecta a lacunaO usuário final, em produçãoO stakeholder, lendo o requisito

Corrigir uma regra de negócio errada num arquivo de requisitos custa uma frase. Corrigir a mesma regra depois que virou código, testes e integração custa uma sprint. O approval gate move a decisão para o momento mais barato possível.

flowchart LR
    Req["📋 Requisitos<br/>requirements.md"] --> G1{"👤 Aprovar?"}
    G1 -->|sim| Des["🏗️ Design<br/>design.md"]
    G1 -->|ajustar| Req
    Des --> G2{"👤 Aprovar?"}
    G2 -->|sim| Tar["✅ Tarefas<br/>tasks.md"]
    G2 -->|ajustar| Des
    Tar --> Impl["⚙️ Implementação"]

Vale a nota honesta: o Kiro também oferece um modo Quick Plan, que gera os três artefatos de uma vez, sem os portões de aprovação. É ótimo para protótipos e exploração — mas justamente quando o negócio precisa validar, é o fluxo com gates que protege você.

Rastreabilidade: a resposta para “cobrimos tudo?”

Toda reunião de fim de entrega tem a mesma pergunta ansiosa: “a gente cobriu tudo o que foi pedido?”. No modelo tradicional, a resposta é um encolher de ombros coletivo e uma rodada de testes manuais na esperança de pegar o que faltou.

O Kiro liga cada tarefa técnica de volta ao requisito que a originou. O tasks.md fica assim:

# Plano de implementação

- [ ] 1. Criar migration da tabela reviews (Req 1)
- [ ] 2. Implementar ReviewRepository com verificação de compra (Req 1)
  - [ ] 2.1 Testes unitários do repositório
- [ ] 3. Endpoint POST /products/{id}/reviews (Req 1)
  - [ ] 3.1 Teste de integração (403 sem compra)
- [ ] 4. Filtro de moderação (Req 1 - WHERE)

Olhe as anotações entre parênteses: (Req 1), (Req 1 - WHERE). Cada linha de trabalho declara de qual requisito ela nasceu. Isso cria uma linha reta entre o que o negócio pediu e o que o time está fazendo. A tarefa 4 existe porque existe aquela regra WHERE sobre moderação de linguagem. A subtarefa 3.1 testa exatamente o “403 sem compra” da regra IF/THEN.

Para o PO, isso responde três perguntas de uma vez:

  • Cobrimos tudo? Se um requisito não tem nenhuma tarefa apontando para ele, ele não foi implementado. É visível.
  • Por que essa tarefa existe? Ela cita o requisito. Nada de trabalho órfão que ninguém sabe de onde veio.
  • O que muda se eu mudar de ideia? Ao alterar um requisito, dá para ver imediatamente quais tarefas são afetadas.

E há um detalhe que faz diferença no médio prazo: as specs ficam sincronizadas com o código conforme ele evolui. O documento não é uma foto do dia do kickoff que envelhece na gaveta — ele acompanha o produto vivo. O checkbox marcado no tasks.md é o status real, não o status que alguém lembrou de atualizar no board.

Rastreabilidade não é burocracia. É a diferença entre “acho que entregamos” e “aqui está a linha que prova o que entregamos”.

A conexão com o AI-DLC: o negócio valida junto

Nada disso é um truque isolado de ferramenta. Ele se encaixa numa mudança maior de como times constroem software com IA — o AI-DLC (AI-Driven Development Life Cycle), um modelo criado por Raja SP, arquiteto principal da AWS, com white paper aberto e repositório open source.

A ideia central do AI-DLC cabe em uma linha: a IA cria um plano, faz perguntas, e só implementa depois da validação humana. A IA não decide sozinha; ela propõe e pergunta, e as decisões que importam ficam com as pessoas.

A primeira fase do AI-DLC se chama Inception, e nela acontece a Mob Elaboration — um momento em que o time (não só os desenvolvedores, mas produto e stakeholders também) senta junto para transformar a intenção em requisitos e stories. E aqui está o ponto que interessa ao negócio: é o time que valida as perguntas que a IA faz.

Quando o Kiro pergunta “o usuário precisa ter comprado o produto para avaliar?”, essa pergunta não é um detalhe técnico — é uma decisão de negócio que estava escondida na frase original. Na Mob Elaboration, é o PO, e não o desenvolvedor adivinhando, quem responde. A IA vira uma máquina de expor as ambiguidades que sempre existiram; o time humano vira o dono das respostas.

O contexto dessas decisões fica persistido no repositório entre as sessões. Ou seja: a conversa que resolveu aquela ambiguidade não some no histórico do Slack. Ela vira parte da spec, disponível para a próxima pessoa que chegar ao projeto. (Não vou aprofundar aqui — o AI-DLC tem três fases e vocabulário próprio, como chamar sprints de bolts e epics de units of work — mas o essencial para o negócio é este: você é parte ativa da elaboração, não o destinatário final de uma surpresa.)

O que muda na cultura: o negócio como coautor

O efeito mais profundo de tudo isso não está na ferramenta — está na dinâmica do time.

No modelo antigo, o papel do negócio era encomendar e esperar. Você entregava o pedido na porta da engenharia e torcia para que o que voltasse fosse parecido. O documento de requisitos, quando existia, era escrito para o time técnico, numa linguagem que só ele lia, e o negócio assinava embaixo sem realmente conseguir auditar.

Com specs legíveis, EARS sem jargão e rastreabilidade explícita, o papel muda: o negócio vira coautor. O requirements.md é escrito numa linguagem que você entende, revisa e corrige. As perguntas da IA na elaboração são endereçadas a você. O approval gate exige a sua assinatura — uma assinatura informada, não cega.

Isso redistribui algo que costumava ser desequilibrado: a responsabilidade pela clareza. Antes, se a entrega saía errada, a culpa oscilava entre “o requisito era ruim” e “o time não entendeu”. Agora existe um artefato compartilhado, versionado e aprovado por ambos os lados. A conversa deixa de ser “quem errou?” e passa a ser “o requisito dizia X — vamos ajustar o requisito ou o código?”.

Há um custo cultural nisso, e é justo nomeá-lo: o negócio precisa se envolver mais cedo e ler com atenção. Aprovar uma spec sem ler é tão perigoso quanto assinar um contrato sem ler — a diferença é que agora o documento está numa linguagem que você de fato consegue ler. A ferramenta remove a desculpa técnica; o que ela pede em troca é participação.

Quando o requisito está escrito numa língua que o negócio lê, “não foi isso que eu pedi” deixa de ser uma frase de demo e vira uma linha que dava para corrigir na segunda-feira.

Principais aprendizados

  • A dor real do software é a tradução, não o código. O Kiro ataca o vão entre intenção e entrega colocando a intenção dentro do repositório, num formato legível para o negócio.
  • EARS torna requisitos auditáveis por não-técnicos. WHEN, IF, WHILE, WHERE são gatilhos claros com consequências claras — o fim do “depende”.
  • Approval gates movem a correção para o momento mais barato. Você conserta um parágrafo, não uma sprint.
  • Rastreabilidade responde “cobrimos tudo?” com evidência, ligando cada tarefa ao requisito que a originou.
  • O AI-DLC coloca o negócio como validador das perguntas da IA na Mob Elaboration — e o contexto fica no repositório, não no chat que ninguém acha depois.
  • A mudança maior é cultural: o negócio deixa de encomendar e esperar, e passa a ser coautor da spec. Em troca, precisa se envolver cedo e ler.

Referências


Este artigo foi publicado originalmente no Medium. Preços, nomes de modelos e detalhes de produto refletem o estado do Kiro em meados de 2026 e podem mudar — confirme em kiro.dev antes de tomar decisões. Este é um conteúdo educacional independente, sem vínculo oficial com a AWS.

Tags: kiro, produto, requisitos, ai-dlc, gestao-de-produto

Publicado originalmente em prompt.victorbatistax.com. Se você chegou por outra plataforma, esta é a versão canônica.