Spec-Driven Development:From Code to Contract in the Age of AI Coding Assistants
Este artigo apresenta um guia abrangente para o Desenvolvimento Baseado em Especificação (SDD), delineando seus princípios, três níveis de rigor de especificação e ferramentas de suporte para demonstrar como tratar as especificações como o artefato primário pode alavancar efetivamente assistentes de codificação de IA em diversos domínios de software.
Artigo original sob licença CC BY 4.0 (http://creativecommons.org/licenses/by/4.0/). Esta é uma explicação gerada por IA do artigo abaixo. Não foi escrita nem endossada pelos autores. Para precisão técnica, consulte o artigo original. Ler aviso legal completo
Imagine que você está contratando um robô chef muito talentoso, incrivelmente rápido, mas um pouco literal demais para cozinhar uma refeição complexa para você.
O Jeito Antigo (Focado em Código):
Você se aproxima do robô e diz: "Faça um jantar delicioso para mim".
O robô, ansioso para agradar, começa imediatamente a picar vegetais e aquecer panelas. Ele supõe que você quer massa. Ele supõe que você quer que seja apimentado. Ele supõe que você queira usar aquele azeite de trufa caro que você nem mencionou.
Dez minutos depois, você tem um prato de massa com trufa e pimenta. Você queria uma salada.
Agora você tem que dizer ao robô para parar, jogar a massa fora e começar de novo. Isso é o que o artigo chama de "vibe coding" — confiar em comandos vagos onde a IA tem que adivinhar sua intenção. O resultado é frequentemente uma bagunça que exige correção constante.
O Jeito Novo (Desenvolvimento Baseado em Especificação):
Em vez de gritar ordens, você primeiro escreve um cartão de receita (a Especificação).
Você escreve exatamente: "Eu quero uma salada. Use espinafre, tomates e feta. Sem nozes. Tempero à parte. Servir em temperatura ambiente".
Você entrega este cartão ao robô. O robô o lê, verifica seu entendimento e, então, começa a cozinhar.
Se o robô tentar adicionar nozes, ele para porque o cartão diz "Sem nozes". Se ele tentar servir quente, ele para.
Neste cenário, o cartão de receita é o chefe. A comida (o código) é apenas o resultado de seguir a receita. Se a comida tiver um gosto ruim, você não culpa o chef; você verifica se a receita estava clara.
Os Três Níveis de Rigidez
O artigo explica que você nem sempre precisa de um contrato de 50 páginas. Existem três maneiras de usar esta abordagem de "cartão de receita", dependendo de quão sério você é:
Spec-First (O "Esboço"):
- O que é: Você escreve a receita antes de começar a cozinhar para garantir que todos concordem sobre o que estão fazendo.
- Quando usar: Ótimo para testar uma nova ideia ou um projeto pontual.
- O Problema: Uma vez que a refeição é cozida, você pode jogar o cartão de receita fora. Se você mudar a receita mais tarde, o cartão pode não ser atualizado. É bom para começar, mas não para manutenção de longo prazo.
Spec-Anchored (O "Menu Vivo"):
- O que é: O cartão de receita é mantido na geladeira ao lado do fogão. Toda vez que você muda o prato (adiciona mais queijo, muda o tempero), você deve atualizar o cartão imediatamente.
- Quando usar: Este é o ponto ideal para a maioria das cozinhas profissionais (software de produção).
- A Magia: A cozinha tem um inspetor robô. Se o chef mudar o prato mas esquecer de atualizar o cartão, o inspetor soa um alarme. Isso garante que o menu (documentação) sempre corresponda à comida (software).
Spec-as-Source (A "Impressora 3D"):
- O que é: Esta é a versão mais extrema. Você nunca toca a comida diretamente. Você apenas edita o cartão de receita. Uma máquina então automaticamente imprime a comida baseada apenas naquele cartão.
- Quando usar: É usado em campos de alto risco, como construção de motores de carros ou dispositivos médicos, onde um erro pode ser perigoso.
- A Regra: Se você quiser mudar os freios de um carro, você não coloca a mão sob o capô com uma chave de fenda. Você altera o projeto e a máquina reconstrói os freios perfeitamente. Você nunca tem permissão para editar manualmente as partes geradas.
Por Que a IA Torna Isso Necessário
O artigo argumenta que os assistentes de codificação por IA são como esse robô chef talentoso, mas literal. Eles são incríveis em seguir instruções, mas péssimos em "ler mentes".
- Sem uma especificação: Você pede para a IA "adicionar um recurso de login". A IA adivinha as regras de senha, o tipo de banco de dados e o nível de segurança. Ela frequentemente erra.
- Com uma especificação: Você dá à IA um contrato claro: "O login requer uma senha de 12 caracteres, usa e-mail e bloqueia a conta após 3 tentativas falhas". A IA segue as regras perfeitamente.
O Fluxo de Trabalho: Uma Dança de Quatro Passos
O artigo sugere um ritmo simples para este processo:
- Especificar: Escreva o "O quê". (A Receita).
- Planejar: Escreva o "Como". (A lista de compras e o layout da cozinha).
- Implementar: Construa. (O ato de cozinhar).
- Validar: Verifique. (A degustação). Se o sabor não corresponder à receita, você corrige a cozinha ou atualiza a receita, mas você nunca ignora a discrepância.
Quando Usar (E Quando Não Usar)
O artigo fornece um guia de decisão simples:
- Use quando: Você estiver construindo algo grande, trabalhando em equipe, usando IA ou construindo algo onde erros são caros (como bancos ou carros).
- Não use quando: Você estiver fazendo um protótipo rápido para descartar, ou se for um desenvolvedor solo construindo um aplicativo de lista de tarefas simples onde os requisitos são óbvios. Nesses casos, escrever uma receita detalhada é apenas perda de tempo.
A Grande Conclusão
Por décadas, os desenvolvedores de software escreviam o código primeiro e escreviam a "receita" (documentação) depois, se é que a escreviam. Este artigo diz: Inverta o roteiro.
Faça da Especificação a principal coisa que você cria. Trate o Código apenas como o output automático dessa especificação.
Ao fazer isso, você para de adivinhar, para de lutar com suas ferramentas de IA e garante que o que você constrói é exatamente o que você pretendia construir. O código torna-se uma sombra da especificação, e não o contrário.
Afogado em artigos na sua área?
Receba digests diários dos artigos mais recentes que correspondam às suas palavras-chave de pesquisa — com resumos técnicos, no seu idioma.