SE VOCÊ SÓ TEM 30 SEGUNDOS || DIRETO AO PONTO
→ Spec-Driven Development é o oposto do Vibe Coding. Em vez de pedir código direto, você investe em clareza e a IA entrega resultados dramaticamente melhores.
→ O fluxo tem 8 etapas e 3 pontos importantes de envolvimento humano. A geração de código com IA só acontece na etapa 7. As 6 anteriores constroem o contexto que faz o código funcionar de verdade.
→ EARS é o formato que elimina ambiguidade. Evento + Comportamento + Limites = especificações que a IA (e o time) entendem, sem margem para interpretação.
→ O resultado é uma tríade: mais produtividade, melhor time-to-market e mais qualidade. Tudo ao mesmo tempo e não como trade-off.
→ O desenvolvedor não perde relevância. Ele evolui. Nasce o "Super Desenvolvedor" — curioso, sistemático e totalmente responsável pelos resultados, mesmo quando a IA executa.
Olá!
Na edição passada, falei sobre os problemas reais do "Vibe Coding" e por que velocidade sem direção é a receita para dívida técnica em escala.
Por outro lado, não podemos ignorar o potencial de ganho com o uso de IA no ciclo de vida de desenvolvimento de software. Então, qual seria a melhor forma de abordar o AI-SDLC ?
A Engenharia de Software vive em constante evolução
Antes de entrar no método, quero colocar em perspectiva: a forma de construir software sempre evoluiu. E toda vez que mudou, o medo foi o mesmo: "isso vai nos substituir?".
No passado, a programação em “linguagem de máquina” deu lugar a compiladores. A programação estruturada evoluiu para orientação a objetos. Monolitos migraram para microsserviços. Infraestrutura on-premise foi para a nuvem e, mais recentemente, surgiram os conceito de ”cloud-native” e “serverless”.
Em nenhuma dessas transições, os desenvolvedores desapareceram ou perderam relevância. O que mudou foi o escopo e a responsabilidade. O trabalho de execução, como a escrita de código e a montagem de servidores, diminuiu. O trabalho de design, arquitetura e decisão aumentou.
Com IA no desenvolvimento, estamos vivendo exatamente a mesma transição. A diferença é que, dessa vez, a mudança é mais rápida. E quem adota cedo, sai na frente.
O que é Spec-Driven Development
A ideia central é simples e poderosa:
Antes de gerar código, precisamos gerar clareza.
Spec-Driven Development é um modelo onde cada fase do ciclo de desenvolvimento produz artefatos claros — requisitos, definições, especificações, design — que são revisados, refinados e validados por humanos antes de avançar para a próxima etapa.
A IA participa de todas as fases. Mas o humano mantém o comando e o controle em cada transição.
Isso significa que:
→ A intenção é definida antes da execução e elimina a ambiguidade
→ O desenvolvedor revisa e refina cada fase antes de avançar, mantendo controle
→ A qualidade é construída desde o início, ao invés de ser apenas testada no final
→ As entregas são mais rápidas, porque há menos retrabalho e desvios sobre o resultado final
O fluxo na prática: 8 etapas, 3 gates
O ciclo de Spec-Driven Development funciona em 8 etapas, com 3 gates de validação humana. Cada etapa, pode e deve utilizar IA para avançar na construção de seus artefatos e cada Gate deve funcionar como um checkpoint: só avança quando o humano aprova.
1 ) Requisitos
Definição dos requisitos funcionais e não funcionais que o sistema deve atender, descrição dos objetivos a serem alcançados, das diferentes personas e tipos de usuários, incluindo permissões e limites.
O objetivo é definir bem o que precisa ser construído e por quê.
2 ) Direcionamentos (Steering)
Definições e boas práticas que devem ser seguidas: descrição do produto que deve ser construído, incluindo suas características e objetivos. Definição dos padrões de código, das tecnologias a serem utilizadas, convenções de arquitetura, restrições que precisam ser respeitadas, regras de segurança, abordagem de construção e execução de testes, entre outras coisas.
Como “Boa Prática”, existem artefatos que podem (e devem) ser compartilhados e reutilizados entre projetos, enquanto outros serão mais específicos.
3 ) Especificação EARS
Quebra dos requisitos em blocos funcionais (que funcionam como os épicos das metodologias ágeis) e a transformação destes blocos em especificações não-ambíguas usando o formato EARS — Easy Approach to Requirement Syntax.
GATE 1: Revisar & Refinar Spec
Esse é um processo iterativo e devem ser feitas quantas rodadas de refinamento forem necessárias para garantir a coerência e completude das User Stories antes de avançar.
4 ) Design
Arquitetura, padrões e decisões técnicas de projeto para a construção do bloco funcional em questão. Como o sistema será construído.
GATE 2: Revisar & Refinar Design
Humano no loop para garantir que o "como" está aderente à arquitetura desejada
5 ) Tarefas / Atividades
Decomposição em atividades/passos concretos para guiar a implementação, totalmente baseada nas especificações e no Design definidos nos GATES 1 e 2.
6 ) Definição de Testes
Cenários de teste definidos antes de iniciar a escrita do código, garantindo a qualidade, aderência e cobertura dos testes, incluindo cenários de regressão.
GATE 3: Revisar & Refinar Tasks + Testes
Humano revisa, refina e valida todo o plano de implementação e os critérios de aceitação.
7 ) Geração de Código
Agora sim, a IA gera código. Tirando vantagem de um contexto bem mais completo e bem definido: sabe o que construir, como construir, e como testar.
8 ) Revisão & Deploy
Code review, execução dos testes definidos, validação end-to-end e deploy com governança.
O ponto fundamental: a IA só gera código na etapa 7. As 6 etapas anteriores são investimento em clareza. E é exatamente esse investimento que faz o código gerado ser aderente, testável e production-ready.
Ao evoluir um código e/ou corrigir um bug existente, é necessário descrever com clareza o que deve ser alterado e o que deve ser mantido.
EARS: especificações que a IA (e as pessoas) entendem
Um dos elementos mais práticos do Spec-Driven Development é o formato EARS — Easy Approach to Requirement Syntax.
Cada especificação é formada por declarações claras do que o sistema deve fazer, usando uma estrutura simples:
→ Trigger — evento, condição ou estado que dispara o comportamento
→ Behavior — o que o sistema deve fazer ou como deve se comportar
→ Constraints — limitações de tempo, permissões, tratamento de erros, auditoria
O formato padrão:
When <trigger/condição> the system shall <comportamento observável + tratamento de erros, timing, permissões>
Alguns exemplos concretos:
// Requisito simples (sem trigger)
The system shall encrypt all stored customer data at rest.
// Com trigger de evento
When the user requests a password reset, the system shall send a reset link to the user's registered email.
// Com condição de estado
While the account is suspended, the system shall block login attempts.
// Com trigger + constraint de tempo
If the system detects more than 5 failed login attempts within 10 minutes, the system shall lock the account for 15 minutes.
// Composto: trigger + fallback + auditoria
When an order status changes, if the preferred channel is unavailable, the system shall retry up to 3 times and log the error.Por que isso é tão poderoso com IA? Porque cada spec EARS é precisa, testável e não-ambígua. Quando você entrega isso para a IA como contexto, o código gerado é dramaticamente melhor do que tentativas de “Vibe Coding”.
É a diferença entre dizer "faz um sistema de login" e especificar exatamente os comportamentos, triggers e constraints.
O valor real: produtividade + qualidade + velocidade
Quando o Spec-Driven Development é implementado com IA de forma disciplinada, três coisas acontecem ao mesmo tempo:
Mais produtividade
A capacidade de entrega do time existente se multiplica. A IA atua como aceleradora em cada etapa do ciclo — desde ajudar a escrever specs até gerar código e testes. O time não cresce, mas entrega mais.
Melhor time-to-market
Velocidade vira vantagem competitiva real. E como o retrabalho diminui drasticamente (porque os requisitos são claros desde o início), o tempo total de projeto cai — mesmo investindo mais nas fases iniciais.
Mais qualidade
Qualidade deixa de ser gargalo e passa a ser padrão. Especificações claras geram código aderente. Testes definidos antes do código garantem cobertura. O débito técnico deixa de se acumular.
Não é escolher entre velocidade e qualidade.
É usar disciplina para ter os dois ao mesmo tempo.
O Super Desenvolvedor
Esse modelo muda o perfil do desenvolvedor. Ao invés de substituir, ele aumenta a importância e a relevância. Eu tenho chamado isso de "Super Desenvolvedor": o profissional que usa IA como multiplicador, mantendo o controle e a responsabilidade sobre o código gerado.
As habilidades que importam nesse novo contexto:
→ Curiosidade — cultivar o hábito de explorar e perguntar "a IA pode ajudar aqui?"
→ Experimentação — a IA reduz o custo de experimentar. Use isso para iterar e aprender mais rápido.
→ Comunicação — prompts precisos e especificações detalhadas viram habilidade central
→ Pensamento sistêmico — entender como mudanças se propagam pela arquitetura, fluxos e dependências
→ Colaboração — compartilhar conhecimento e ancorar o uso da IA na realidade do time
→ Responsabilidade — assumir total responsabilidade pelo resultado. Revisar e testar rigorosamente tudo que a IA gera.
O desenvolvedor não é substituído e sim potencializado pela IA. Quando a execução acelera, o gargalo vira o pensamento: requisito, design, validação e a governança.
Na prática: por onde começar?
Se você quer experimentar Spec-Driven Development no seu time, sugiro começar assim:
Escolha um projeto pequeno — um novo módulo ou feature, não uma reescrita completa
Invista nas specs — antes de qualquer linha de código, utilize IA para transformar os requisitos em EARS e faça o time revisar
Defina os gates — marque pontos claros de revisão antes de avançar entre fases e quem são as pessoas (perfis) responsáveis pela validação de cada etapa
Use a IA como parceira, não como substituta — deixe a IA sugerir, gerar, acelerar. Mas o humano decide.
Meça o resultado — compare retrabalho, tempo de entrega, cobertura de testes e qualidade com projetos anteriores
Se você conhece alguém que ainda está no "Vibe Coding", compartilha essa edição.
IA que Funciona.
Estratégia e execução, com governança e ROI.
VALE A PENA CONFERIR
Uma curadoria de notícias, novidades e outros links pra ficar por dentro do que anda acontecendo pelo mundo, relacionado aos temas da IA que Funciona.
aaaaa
aaaaa
aaaaa
PUBLICAÇÕES RELACIONADAS

Manifesto da IA que funciona


