Quando um prompt solto não é suficiente
O seu time provavelmente já usa um assistente de IA no código todo dia: um pedido rápido no chat, e a função sai pronta, ou quase. Para um ajuste pontual isso funciona bem. O problema aparece quando a tarefa cresce: ela toca três módulos diferentes, depende de uma decisão de arquitetura que alguém tomou no meio de uma conversa, e dois meses depois ninguém lembra por que aquele caminho foi escolhido. A conversa que explicava a decisão já rolou para outro assunto, ou a sessão foi fechada havia semanas.
É esse vão, entre a decisão tomada e o motivo dela sobreviver, que o desenvolvimento orientado a specs (spec-driven development) foi feito para fechar. A ideia, descrita na documentação de specs do Kiro, é simples de enunciar e trabalhosa de praticar sem uma ferramenta que sustente o processo: antes de qualquer código, você formaliza o que precisa ser resolvido, como vai ser resolvido e quais passos levam até lá. Essas 3 partes ficam escritas, revisáveis e, depois, versionadas no mesmo repositório do código que elas geraram.
O que é uma spec, de fato
Uma spec não é um documento de requisitos arquivado numa ferramenta separada, que ninguém abre de novo depois do kickoff. No Amazon Kiro, toda spec gera 3 arquivos que moram junto do código, no próprio repositório, e podem ser lidos, comentados e atualizados como qualquer outro arquivo do projeto.
As 3 partes que toda spec produz
requirements.md: as histórias de usuário e os critérios de aceite, na notação que a seção seguinte explica.design.md: a arquitetura técnica, com diagrama de sequência e as decisões de implementação, documentadas antes da primeira linha de código.tasks.md: o plano de implementação, quebrado em tarefas discretas e rastreáveis, com status atualizado em tempo real conforme o trabalho avança.
A documentação oficial descreve o fluxo em 3 fases, sempre nessa ordem:
requisito (ou análise do bug, para uma spec de correção), design e tarefas. Cada fase só avança
depois que a anterior foi revisada, o que é exatamente o ponto: a decisão de arquitetura não fica
perdida numa conversa de chat, ela está escrita no design.md, ao lado do motivo que levou a ela.
A notação EARS no requisito
O requirements.md usa a notação EARS (Easy Approach to Requirements Syntax) para transformar
uma ideia solta em um critério de aceite testável. O padrão, conforme a documentação de
Feature Specs, segue o formato:
WHEN [condição ou evento]
THE SYSTEM SHALL [comportamento esperado]
Um exemplo real da própria documentação do Kiro:
WHEN a user submits a form with invalid data
THE SYSTEM SHALL display validation errors next to the relevant fields
A vantagem de escrever nesse formato, em vez de uma frase corrida, é que cada linha já nasce como um caso de teste em potencial: ela diz a condição, o comportamento esperado, e nada mais. Quem revisa não precisa interpretar a intenção por trás de um parágrafo; o requisito já está na forma que vai ser verificada.
Da aprovação em cada fase às ondas de tarefas
Depois que o tasks.md existe, você pode rodar uma tarefa por vez, acompanhando o status em tempo
real, ou rodar todas de uma vez. Nesse segundo caso, o Kiro monta um grafo de dependências entre as
tarefas e agrupa em ondas: a primeira onda roda todas as tarefas sem dependência, em paralelo; a
onda seguinte libera as tarefas cujas dependências a onda anterior satisfez; e assim por diante,
até a última onda. As ondas rodam em sequência, mas as tarefas dentro de cada onda rodam ao mesmo
tempo, o que reduz bastante o tempo de execução sem que você precise desenhar essa ordem à mão.
Requisito primeiro, ou design primeiro
A documentação de Feature Specs descreve 2 variantes de fluxo, e a escolha depende de onde o seu time já está no raciocínio. No fluxo Requirements-First, você parte do comportamento que o sistema precisa ter, e o design é gerado a partir dos requisitos; é o caminho natural quando a feature nasce de um pedido de produto ou de feedback de cliente, e a arquitetura ainda tem liberdade para se adaptar. No fluxo Design-First, você parte de uma arquitetura ou de um design de baixo nível que já tem em mente, e os requisitos são derivados dali; funciona melhor quando o sistema precisa atender a uma restrição técnica rígida (latência, throughput, conformidade) ou quando você está portando um design que já existia em outra ferramenta. Nenhuma das duas é “a certa”; a pergunta é se a flexibilidade deste projeto está no comportamento ou na implementação.
Em que isso difere de um prompt solto
Um prompt direto resolve uma tarefa isolada: “mude esta função para fazer X”. Ele continua sendo o caminho mais rápido para esse tipo de ajuste, e o Kiro também tem um modo de edição rápida para isso, às vezes chamado de “vibe coding” nas conversas sobre o mercado de assistentes de código. A spec entra num momento diferente: quando a tarefa atravessa vários arquivos ou módulos, ou quando a decisão de design precisa sobreviver além da pessoa que a tomou.
A diferença não é de “qualidade” do código gerado num caso ou no outro. É sobre o que sobra depois: num prompt solto, sobra o código e, se alguém salvar, um histórico de conversa difícil de buscar; numa spec, sobra um artefato estruturado, no mesmo lugar do código, que qualquer pessoa do time pode abrir meses depois e entender por que aquele caminho foi escolhido, sem precisar perguntar para quem escreveu.
Onde isso se encaixa no dia a dia do seu time
Para a maior parte das tarefas pequenas e isoladas, o ajuste direto no código continua sendo o caminho certo: escrever uma spec para uma correção de 2 linhas custaria mais tempo do que economiza. A spec compensa quando o tamanho da tarefa justifica o tempo de escrevê-la, e esse limiar varia de time para time. O sinal mais confiável não é o número de arquivos, é a pergunta: se essa decisão for questionada dentro de 3 meses, onde está a resposta?
Como fica o fluxo do time depois de adotar specs
Quem adota specs troca “abrir uma conversa nova e explicar o contexto de novo” por abrir o
design.md da feature e ver a decisão já registrada, com o motivo ao lado. O requisito, escrito em
EARS, vira direto um roteiro de teste; o plano de tarefas mostra o que já foi feito e o que falta,
sem precisar perguntar no chat da equipe; e quando uma tarefa precisa ser revisitada, a spec
inteira, não só o código, está ali, versionada, para quem for revisar.
A CloudDog, Advanced Partner AWS, implanta o Amazon Kiro no seu time de desenvolvimento, com configuração, integração à sua conta AWS e capacitação, para que a adoção de specs não dependa de cada desenvolvedor descobrir o processo por conta própria. Conheça o Amazon Kiro da CloudDog, veja o Kiro Power para testar com apoio de crédito da AWS, ou a página Amazon Kiro para Desenvolvedores se você é quem escreve o código e quer entender o processo antes de propor a adoção para a empresa.

