Spec-Driven Development
Ir para notas que citam estaSpec-Driven Development (SDD) é o desenvolvimento com IA em que agentes e skills se organizam em torno de arquivos de especificação que guiam cada implementação.
A ideia é trocar o improviso do Vibe Coding por um processo repetível: antes de gerar código, a funcionalidade é descrita numa spec, e essa spec é implementada sobre uma base já configurada de agentes, skills e definições técnicas do projeto. O resultado fica consistente com o que já existe porque o agente não precisa adivinhar arquitetura, stack ou convenções: elas estão escritas.
A base de agentes, skills e definições no repositório
A base (o harness) é um conjunto de arquivos markdown que se referenciam. Cada Agente de IA é um arquivo com personalidade, responsabilidades e regras; um agente de engenharia de back-end, por exemplo, traz as linguagens com que implementa e as boas práticas que segue. As Skills de IA concentram conhecimento reutilizável, e arquivos de arquitetura ou de constituição do projeto guardam as definições técnicas. A ferramenta navega entre essas referências e busca o que precisa conforme o desenvolvimento avança.
A granularidade conta. Um agente de arquitetura sabe que o projeto é em Java, segue MVC e usa determinado banco de dados; uma skill separada guarda o conhecimento sobre a arquitetura MVC em si. Quanto mais específica a relação entre agentes e skills para problemas específicos, melhor o resultado.
Agentes, skills e specs devem viver no repositório do projeto. Mantê-los na máquina local de cada desenvolvedor faz o time perder o uso padronizado dos mesmos agentes e do mesmo processo. As specs de cada funcionalidade também vão para o código, e o contexto inteiro fica junto.
O fluxo de uma funcionalidade
Com a base montada, cada nova funcionalidade segue o mesmo caminho: especificar, refinar a especificação, validar e só então implementar e testar. Também é possível partir direto de uma lista de specs e construir a base ao longo do caminho, ao custo de refatorações constantes. Uma skill pode inclusive gerar esse backlog inicial, como faz a Reimagine Your Legend, que termina numa lista de specs pronta para a esteira de implementação.
Frameworks e configuração
Há vários frameworks de SDD. O Spec Kit é um dos mais conhecidos; o OpenSpec é mais rápido de configurar. No OpenSpec, o arquivo de configuração aponta para um markdown de stack que centraliza tecnologias e versões do projeto; ao gerar a spec de uma funcionalidade, o framework consulta essas definições e prepara a implementação de acordo com elas.