O que é Spec Kit?
O Spec Kit é a versão de código aberto do GitHub para o desenvolvimento guiado por especificação. A CLI specify configura um projeto, e comandos de barra no seu agente percorrem uma constituição, uma spec da funcionalidade, um plano técnico, uma lista de tarefas, a implementação e uma etapa de convergência que confere o resultado contra os documentos.
Correção de bugs e avaliação de ideias são extensões opcionais. Presets, workflows, bundles e catálogos permitem às equipes mudar templates, adicionar barreiras de qualidade ou hospedar um catálogo privado de componentes aprovados. Instala-se com uv tool install specify-cli, precisa de Python 3.11 ou mais recente e roda em Linux, macOS e Windows.
Spec Kit vale a pena?
O Spec Kit é o fluxo de trabalho guiado por especificação com mais estrelas no GitHub, e seu valor depende inteiramente de alguém ler as specs. O repositório tem cerca de 142.500 estrelas e lança rápido: a v1.0.0 chegou em 21 de agosto de 2026, e oito releases saíram entre 2 e 22 de outubro, terminando na v1.2.3. A página de integrações lista 41 agentes de programação nomeados, do Claude Code e do Copilot ao Cursor, Codex CLI, Kiro e Zed, além de uma opção genérica.
Sua força é que o contrato vive em arquivos. A constituição, a spec, o plano e as tarefas são Markdown no repositório, então passam por pull requests como o código, e a etapa de convergência confere a implementação contra eles até reportar Converged. Presets podem impor os padrões de uma organização, e a extensão de bugs registra causa, correção e veredito de verificação em .specify/bugs.
O custo é o tempo de leitura. O guia de produção da Wavect diz que ele não deixa, por si só, o código gerado por IA pronto para produção, e quando o CTO da Scott Logic reconstruiu duas funcionalidades com ele, a revisão levou cerca de 3,5 horas e 2 horas, contra mais ou menos meia hora de tempo de agente em cada uma. Para uma correção de uma linha, essa sobrecarga é absurda, e é por isso que a extensão de bugs pula o fluxo completo de funcionalidade.
Dois pontos de governança importam para quem compra. As entradas do catálogo da comunidade servem só para descoberta, não são auditorias, então uma equipe deve manter um catálogo privado de extensões aprovadas, o que o Spec Kit suporta, junto com instalações offline. E o ritmo semanal de releases significa que templates e nomes de comandos mudam; fixar uma release, como descreve a documentação de instalação, mantém todos os engenheiros no mesmo processo. O BMAD cobre um terreno parecido com mais personas, e rodar os dois em um mesmo projeto produz dois conjuntos de planos concorrentes.
Onde ele se destaca
Um tech lead em uma equipe de produto de 12 engenheiros que usa Copilot e Claude Code
Tornar revisáveis as funcionalidades feitas por agentes antes de o código ser escrito
Cada funcionalidade ganha uma spec e um plano em um pull request que um engenheiro sênior aprova antes de /speckit-implement rodar. O software é gratuito, mas reserve horas, não minutos, de revisão humana por funcionalidade não trivial.
Um diretor de engenharia em uma fintech regulada
Mostrar aos auditores como as mudanças assistidas por IA foram especificadas e verificadas
Um preset codifica os padrões da empresa na constituição, e um catálogo privado limita as extensões às aprovadas. A spec, o plano e a saída da convergência no git formam uma trilha documental; o risco é os revisores aprovarem documentos longos sem ler.
Um desenvolvedor solo corrigindo um bug em produção com um agente
Corrigir uma falha sem perder de vista a causa
`specify extension add bug`, e então os comandos de avaliação, correção e teste escrevem um relatório cujo veredito é verified, partial ou failed. Mais leve que o fluxo de funcionalidade e custa apenas o uso do próprio agente.
Antes de decidir
- Configuração
- `uv tool install specify-cli` e depois `specify init my-project --integration copilot` (Python 3.11+, uv, um agente suportado); a primeira spec sai de alguns comandos de barra no chat do agente.
- Integrações
- 41 agentes nomeados, incluindo Claude Code, GitHub Copilot, Gemini CLI, Codex CLI, Cursor, Cline, opencode, Kiro CLI e Zed; extensões, hooks, presets, workflows e bundles para personalização.
- Dados e privacidade
- Roda localmente e escreve Markdown no seu repositório; seu agente envia esse conteúdo ao próprio provedor de modelo. A documentação não menciona telemetria. Licença MIT; nenhum aviso de segurança publicado no GitHub.
- Custo em escala
- Não há edição paga. Os custos reais são o uso do agente no seu plano atual e o tempo dos revisores: cerca de 2 a 3,5 horas por funcionalidade no teste publicado pela Scott Logic.
- Limites
- Releases semanais mudam os templates; o catálogo da comunidade não é auditado; pesado para mudanças pequenas; não combina de forma sensata com o BMAD em um mesmo projeto.
O que é bom
- Spec, plano e tarefas revisados no git como código
- 41 integrações com agentes nomeados mais uma opção genérica
- Catálogos privados e instalações isoladas da rede para empresas
- A etapa de convergência confere o código contra a spec
O que não é
- Horas de revisão de documentos por funcionalidade não trivial
- Exagerado para correções pequenas
- As entradas do catálogo da comunidade não são auditadas
- Releases frequentes mudam templates e comandos
Ideal para
Equipes que querem specs escritas e revisáveis antes que um agente escreva código.
Alternativas ao Spec Kit
Spec Kit: perguntas frequentes
- Spec Kit vale a pena?
- O Spec Kit transforma o trabalho do agente em documentos revisáveis no git, e cobra por isso em horas de leitura humana por funcionalidade. Damos nota 4.3 de 5.
- Quanto custa Spec Kit?
- Gratuito e de código aberto (MIT).
- Quais são as desvantagens de Spec Kit?
- Horas de revisão de documentos por funcionalidade não trivial; exagerado para correções pequenas; as entradas do catálogo da comunidade não são auditadas; releases frequentes mudam templates e comandos.
- Para quem Spec Kit é indicado?
- Equipes que querem specs escritas e revisáveis antes que um agente escreva código.
- Quanto custa Spec Kit para uma equipe ou em produção?
- Não há edição paga. Os custos reais são o uso do agente no seu plano atual e o tempo dos revisores: cerca de 2 a 3,5 horas por funcionalidade no teste publicado pela Scott Logic.
- Spec Kit é seguro para dados da empresa?
- Roda localmente e escreve Markdown no seu repositório; seu agente envia esse conteúdo ao próprio provedor de modelo. A documentação não menciona telemetria. Licença MIT; nenhum aviso de segurança publicado no GitHub.
- Quais são as melhores alternativas ao Spec Kit?
- As alternativas mais próximas que analisamos são BMAD Method, Superpowers e Matt Pocock's Skills.
Respostas verificadas em 26 de out. de 2026.