Engenharia · Spec Kit

Quatro comandos. Ciclo completo, sprint após sprint.

Spec Kit é a ferramenta open source do GitHub que transforma intenção em entrega. Nas squads Amazing, ela roda integrada a Cursor e Claude Code em cada feature do cliente. Ordem fixa, responsabilidade clara, output auditável em cada fase.

O cenário

Sem fluxo padronizado, cada feature renegocia o método.

Times sem ciclo definido começam cada feature do zero. Quem escreve o quê. Onde fica a especificação. Como acontece a aprovação. Quem revisa o código. Cada decisão precisa ser tomada de novo, sprint a sprint.

O custo invisível é alto: handoff opaco, retrabalho por mal-entendido, decisão diluída em mensagens de Slack. O time entrega, mas com fricção que não aparece nos números até que o ritmo trava.

Spec Kit resolve isso com quatro comandos versionados que estabelecem o método em código. O ciclo vira artefato reproduzível, não combinado verbal.

Como a Amazing aplica

Quatro comandos. Quatro entregáveis auditáveis.

  1. /specify  Define o que construir.

    Intenção, escopo, contratos de API, casos de borda, critério de aceite. Saída versionada como spec QMD no repositório do projeto.

  2. /plan  Decide arquitetura.

    Stack técnica, decisões arquiteturais, trade-offs documentados. Saída versionada como ADR no vault Obsidian. Decisão fica rastreável.

  3. /tasks  Quebra em execução.

    Tarefas atômicas, ordenadas, com entrada e saída definidas. Saída versionada como issues. Cada tarefa pode ser executada em paralelo por agentes diferentes.

  4. /implement  Agentes executam.

    Agentes leem a spec, executam contra ela, geram commits atômicos, abrem PR. O dev sênior valida. Cada PR cita a seção da spec que cumpriu.

terminal · ciclo Spec Kit
$ amazing /specify
› Feature: Pix Automático v1.2
› Spec gerada em specs/pix-auto.qmd
› Aprovação solicitada · 2 reviewers
  ✓ Spec aprovada · commit a3f9c2

$ amazing /plan
› Stack: Node 22, Postgres 16
› ADR-014 criado em vault/decisions/
  ✓ Plano aprovado · commit b41e08

$ amazing /tasks
› 12 tarefas geradas · grafo paralelizável
› T01-T05 → Agente A
› T06-T09 → Agente B
› T10-T12 → Agente C
  ✓ Backlog populado · 12 issues

$ amazing /implement --agents 3
› Executando T01-T12 em paralelo
› Hooks de harness: ativos
› Testes nascendo junto: 47 novos
  ✓ PR #284 aberto · pronto p/ revisão
O que muda para o negócio

Velocidade com handoff legível.

Spec Kit não é só ferramenta. É o protocolo que faz a squad Amazing operar com a mesma disciplina em qualquer projeto, qualquer cliente, qualquer stack.

Padronização 4 etapas

Mesmo método em todos os clientes. Onboarding interno em horas.

Paralelização 3+ agentes

Tarefas executadas em paralelo a partir do mesmo /tasks.

Auditoria 100%

Cada PR vincula spec, plano, task. Histórico completo, sempre.

Tempo de ciclo Dias

Da spec ao PR pronto pra revisão em dias, não semanas.

Diferencial Amazing

Spec Kit é open source. O Spec Kit Amazing é orquestrado.

A ferramenta é pública. O que muda na Amazing é como ela conecta com o resto da operação: harness customizado, vault por cliente, sênior orquestrando, agentes especializados em cada fase.

01

Integrado a Cursor e Claude Code.

Não é processo paralelo. Roda dentro do IDE que o sênior já usa, sem context-switch.

02

Versionado com o repositório.

Cada execução de comando vira commit. Cada decisão tem PR. Histórico completo, auditoria livre.

03

Playbook entre clientes.

O método é o mesmo, o conteúdo é seu. O sênior aplica em qualquer projeto na primeira semana.

Case · Banking

No Pix Automático, 12 tarefas rodaram em paralelo entre 3 agentes. Sem o ciclo Spec Kit, seriam 6 meses sequenciais.

Ver o caso completo
Próximo passo

Quer ver o ciclo rodando?

Em 30 minutos a gente roda os quatro comandos em uma feature sua. Você sai com spec, plano, tasks e PR aberto, mesmo que não feche contrato.

Falar com a Amazing Ver Harness