Spec Kit
Ir para notas que citam estaSpec Kit é o framework de código aberto do GitHub que aplica Spec-Driven Development num fluxo em etapas: constitution, specify, plan, tasks e implement.
Surgiu por volta de setembro de 2025 e é apontado como o framework de Spec-Driven Development mais maduro e mais usado, além de um dos primeiros nesse formato. Não é o SDD em si: o SDD é um conceito, e o Spec Kit é uma das ferramentas que o tornam operável. Cada etapa gera arquivos markdown versionáveis dentro do projeto. Assim, o contexto de uma feature cresce junto com o código em vez de se perder numa conversa de chat.
A vantagem prática é que o agente não precisa manter todo esse material na janela de contexto. Uma feature pode acumular algo na ordem de um milhão de caracteres entre spec, pesquisa, plano e tarefas. Durante a implementação, o modelo consulta os arquivos certos quando precisa, sem queimar contexto o tempo todo.
As etapas do fluxo
- Constitution: os princípios escritos em pedra do projeto, como arquitetura, linguagens, bibliotecas, regras de teste e diretrizes de UX. O time define esses princípios antes de programar, escrevendo à mão ou gerando com a própria ferramenta.
- Specify: parte de uma feature descrita em linguagem simples (criar uma tela de login, por exemplo) e a amplia em nível abstrato, sem falar de implementação. Verifica o que já existe no projeto e descreve a feature em histórias de usuário e cenários de teste de funcionalidade. É contra esse arquivo que o agente confere se a feature foi concluída.
- Clarify: etapa opcional depois do specify, para resolver ambiguidades. Se for pulada, a ferramenta tende a decidir essas pendências sozinha durante o plan.
- Plan: cruza a especificação com o código e com a constitution. Identifica tecnologias, banco e bibliotecas em uso, descreve mudanças de estrutura de dados e monta o plano de implementação. Quando falta conhecimento sobre uma tecnologia, dispara uma pesquisa e grava um arquivo reaproveitável, para que ela não precise ser refeita.
- Tasks: quebra o plano em tarefas executáveis organizadas por camadas (banco, entidades, repositório) e marca quais podem rodar em paralelo, o que permite distribuir o trabalho entre subagentes ou ambientes simultâneos.
- Implement: o agente de código, como o Claude Code ou o Codex, lê tasks, plano e código indicados e implementa seguindo essa estrutura.
Greenfield, brownfield e a comparação com OpenSpec
O Spec Kit se destaca em projetos greenfield, os que começam do zero: dá para construir um sistema inteiro com ele. Numa alteração pequena em um projeto já existente (brownfield), o fluxo completo pesa demais, como usar um canhão para matar uma formiga. Nesse cenário, o OpenSpec costuma encaixar melhor, porque junta specify, plan e tasks numa única proposta e segue direto para a implementação.
As duas ferramentas partem da mesma lógica de especificação, mas criam e organizam os arquivos de formas diferentes. Tecnicamente, dá para usar as duas no mesmo projeto. Escolher uma só é considerado mais sólido e seguro. Qualquer que seja a escolha, o ganho vem de manter a spec desde o início do desenvolvimento: uma regra de negócio definida no começo continua disponível quando uma feature posterior depender dela.
Ao instalar, o Spec Kit pergunta qual ferramenta de IA será usada, porque cada harness organiza os arquivos do seu jeito. O Claude Code usa uma pasta com várias subpastas pequenas, enquanto o Continue concentra tudo numa pasta única.