GitHub Spec Kit: Pare de Vibe Codear e Comece a Construir com Specs
Se você já passou um prompt vago para seu agente de codificação e o viu construir com confiança a coisa errada, spec-kit é para você.
O GitHub acaba de publicar um toolkit open source chamado spec-kit — mais de 68.000 estrelas em poucas semanas — que introduz um workflow estruturado e spec-driven para desenvolvimento assistido por IA. A ideia é simples: em vez de descrever o que você quer em um único prompt e esperar o melhor, você primeiro constrói uma especificação executável e depois deixa seu agente implementar contra ela. Funciona com Claude Code, Cursor, Copilot, Windsurf, Codex e mais de 15 agentes adicionais.
Aqui te explico como começar.
Instale o CLI
Spec-kit vem com um CLI chamado specify. Instale-o uma única vez com uv:
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git
Depois inicialize um novo projeto para seu agente preferido:
specify init meu-projeto --ai claude
# ou para Cursor
specify init meu-projeto --ai cursor-agent
# ou no diretório atual
specify init . --ai claude
Isso gera um diretório .specify/ com templates, scripts e slash commands conectados ao seu agente.
O workflow: 7 comandos que substituem o prompting ad-hoc
Depois de executar specify init, seu agente tem acesso a estes slash commands:
/speckit.constitution — Comece por aqui. Defina os princípios que governam seu projeto: padrões de qualidade de código, requisitos de testes, restrições de arquitetura. Este arquivo guia cada decisão posterior que o agente tomar.
/speckit.specify — Descreva o quê você quer construir e por quê. Foque no comportamento e nas histórias de usuário, não na stack tecnológica. Seja explícito. Quanto mais detalhe você colocar aqui, menos retrabalhado depois.
/speckit.clarify — Execute isto antes de planejar. O agente faz perguntas estruturadas sobre áreas sub-especificadas e registra as respostas. Pular este passo é exatamente como você termina com um app bonito que faz o que não deveria fazer.
/speckit.plan — Aqui sim você especifica a stack tecnológica e a arquitetura. O agente gera um plano de implementação, contratos de API, modelo de dados e documentos de pesquisa baseados em sua spec.
/speckit.tasks — Divide o plano em tarefas ordenadas e acionáveis. Marque as tarefas paralelas com [P], especifique rotas de arquivo exatas e incorpore checkpoints de TDD.
/speckit.implement — Execute a lista de tarefas. O agente valida que a constituição, a spec, o plano e as tarefas estão todos em seu lugar antes de escrever uma única linha de código.
/speckit.checklist / /speckit.analyze — Controles de qualidade opcionais: verificação de consistência entre artefatos e checklists de validação personalizados antes da implementação.
Por que isso importa
O problema com coding assistido por IA não é a capacidade do agente — é a estrutura. Um agente capaz com um prompt vago produz output capaz mas errado. Spec-kit obriga a que a spec exista como um artefato real antes de qualquer código ser escrito, o que significa que seu agente tem algo concreto contra o qual implementar em vez de interpolar de sua intenção.
Isso também torna o desenvolvimento assistido por IA repetível. A spec vive em seu repositório. Um novo membro da equipe — ou uma nova sessão de agente — pode lê-la e entender exatamente o que o sistema deveria fazer e por quê.
O toolkit abrange três cenários explicitamente: projetos greenfield (de 0 a 1), desenvolvimento iterativo de features em codebases existentes (brownfield) e exploração criativa onde você quer prototipar múltiplas abordagens em paralelo.
Experimente
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git
specify init meu-projeto --ai claude
Depois abra Claude Code nesse diretório, execute /speckit.constitution e descreva os princípios do seu projeto. O resto do workflow flui naturalmente.
Spec-kit não vai impedi-lo de vibe codear se isso é o que você quer. Mas para qualquer coisa que você realmente planeja shipear, dá ao seu agente o que lhe faltava: uma spec real a partir da qual trabalhar.
Você já usa algum workflow de specs antes de implementar com seu agente? Ou começa direto do prompt?
Fonte: github/spec-kit