Como Instalar o Spec Kit

Setup do GitHub Spec Kit nos Cinco Principais Agentes: Claude Code, Cursor, Windsurf, Kiro e GitHub Copilot

Tipo: Tutorial · Autor: Aura Research Board · Data: Maio 2026 · Nível: Iniciante · Aura Company

O Que Você Vai Fazer

Instalar o GitHub Spec Kit e inicializar um projeto no agente da sua escolha. Ao final, você terá os comandos de spec-driven development (/constitution, /specify, /plan, /tasks, /implement) disponíveis dentro do seu agente. Este é o pré-requisito do tutorial SDD na Pratica - do Spec ao PR com Spec Kit.

Por Que um Tutorial Só de Instalação

O Spec Kit suporta 29 integrações, e a forma de instalar muda conforme o agente. A diferença principal é entre integrações baseadas em CLI (o agente precisa estar instalado na máquina) e integrações baseadas em IDE (funcionam dentro do editor). Misturar os dois leva a erro de setup. Este guia separa os casos.

Pré-requisitos

uv instalado (gerenciador de pacotes Python da Astral).
Python 3.11 ou superior e git.
O agente escolhido instalado e autenticado. Para integrações CLI isso é obrigatório. Para integrações de IDE, basta ter a IDE.

Passo 1: Rodar o Specify CLI

A forma recomendada usa uvx, que executa o CLI sem instalação global:

uvx --from git+https://github.com/github/spec-kit.git specify init <nome-do-projeto> --integration <key>

Sem o --integration, o terminal interativo pergunta qual agente você usa. Em execução não interativa (CI, pipe), o default é GitHub Copilot. Para ver todas as integrações disponíveis na sua versão:

specify integration list

Passo 2: Escolher a Integração Certa

Use a chave correta para o seu agente. As cinco mais pedidas:

Agente	Chave (`--integration`)	Tipo	Onde os comandos vivem
Claude Code	`claude`	CLI	`.claude/skills` mais o `CLAUDE.md` (integração baseada em skills)
Cursor	`cursor-agent`	IDE	`.cursor/skills` mais `.cursor/rules/specify-rules.mdc`
Windsurf	`windsurf`	IDE	`.windsurf/workflows` mais `.windsurf/rules/specify-rules.md`
Kiro	`kiro-cli`	CLI	`.kiro/recipes/` em formato YAML
GitHub Copilot	`copilot`	IDE e CLI	depende do modo (IDE ou CLI)

Notas que evitam dor de cabeça:

Claude Code e Kiro são CLI: o agente precisa estar instalado e autenticado antes do init.
Cursor e Windsurf são IDE: o setup vive no projeto e funciona ao abrir a pasta na IDE. São seguros para instalação múltipla no mesmo repositório.
GitHub Copilot é híbrido: funciona tanto na IDE quanto via CLI. Confirme em qual modo você vai operar.
Kiro tem uma particularidade: não substitui $ARGUMENTS em prompts baseados em arquivo, e por isso usa um fallback em prosa nas suas recipes YAML.

Passo 3: Conferir a Instalação

Rode a verificação que o próprio Spec Kit oferece:

specify check

Ela confirma se o agente foi detectado e se os comandos foram instalados no lugar certo. Abra o agente e verifique se /specify aparece como comando disponível.

Passo 4: Entender o Que Foi Gerado

A inicialização cria a estrutura do Spec Kit no repositório, incluindo a constitution do projeto (os princípios que governam toda geração de código) e os comandos do fluxo. A partir daqui o ciclo é o mesmo em qualquer agente: /constitution, depois /specify, depois /plan, depois /tasks, depois /implement. O que muda entre agentes é apenas onde os arquivos ficam, não o fluxo.

Próximo Passo

Com o Spec Kit instalado, siga para SDD na Pratica - do Spec ao PR com Spec Kit e entregue uma feature do spec ao pull request.

Conexões no Currículo

Módulos relacionados: M0.6 - Setup Profissional Cursor e Claude

Disciplinas: D2 - Desenvolvimento AI-Native

Frameworks Aura: SDD