O Que É Desenvolvimento Orientado a Specs

Voltar
O Que É Desenvolvimento Orientado a Specs
O Que É Desenvolvimento Orientado a Specs

Por CloudDog, Criado em 21/08/2026

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

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.

Fluxo de uma spec: requisito em notação EARS, design com diagrama de sequência, tarefas quebradas em ondas por dependência, código validado tarefa por tarefa, e a spec versionada no repositório junto do código.Fluxo de uma spec: requisito em notação EARS, design com diagrama de sequência, tarefas quebradas em ondas por dependência, código validado tarefa por tarefa, e a spec versionada no repositório junto do código.

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.

Tags

#SpecDrivenDevelopment #AmazonKiro #AWS #DevOps

Sobre o autor

CloudDog

A CloudDog é uma consultoria especializada em computação em nuvem, parceira AWS, que ajuda empresas a migrar, modernizar, gerenciar e otimizar seus ambientes cloud. Com mais de 400 projetos entregues, combinamos expertise técnica, governança e inovação para acelerar a transformação digital dos nossos clientes por meio de soluções em infraestrutura, segurança, observabilidade, inteligência artificial e serviços gerenciados.

WhatsApp

Política de Privacidade