Pular pro conteúdo

Spec Driven Development skill

O Claude para de sair codando no chute: primeiro escreve o que vai ser feito e como saber que ficou pronto, e só segue com o seu ok.

por addyosmani

instalações
64,8 mil
estrelas no GitHub
110,5 mil
No skills.sh desde
fevereiro de 2026
Licença
MIT

Atualizada no GitHub em 13 de outubro de 2026. Dados conferidos em 26 de outubro de 2026, no skills.sh e no GitHub.

O que ela faz

Antes de codar, lista as suposições que está fazendo e pede correção. Depois escreve um SPEC.md com seis partes: objetivo, comandos de build e teste, estrutura de pastas, estilo de código, estratégia de testes e limites do que sempre fazer, perguntar antes e nunca fazer.

Pedido vago vira critério que dá pra medir: "deixa o painel mais rápido" vira tempo de carregamento com número. Depois de escrever a especificação, resume, lista as dúvidas em aberto e para. O plano só começa quando você aprova, numa mensagem seguinte.

Com o ok, gera o plano em tasks/plan.md e quebra em tarefas pequenas em tasks/todo.md, cada uma com critério de aceite, como verificar e quais arquivos mexe. Se o pedido junta partes independentes, como login, cobrança e avisos, propõe antes um mapa de módulos com a ordem de construção.

Nas palavras de quem fez

Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. Use when drafting a PRD or…

addyosmani, no SKILL.md

Quando usar

  • Começar um projeto ou uma funcionalidade nova do zero
  • Você só tem uma ideia solta e ainda não sabe direito o que quer
  • Mudança que vai mexer em muitos arquivos ou levar mais de meia hora
  • Projeto que junta várias partes, tipo área de membros com pagamento e e-mail

Depois de instalar, é só pedir assim

  • Quero um sistema de agendamento pro meu consultório. Começa pela especificação
  • Antes de mexer em qualquer coisa, escreve a spec da área de membros com pagamento
  • Transforma essa ideia num SPEC.md e me mostra as dúvidas antes de planejar

Segurança

Gen Agent Trust Hub, Socket e Snyk leem o código da skill atrás de comando perigoso, dado vazando e instrução escondida. Alerta não é reprovação: quer dizer que vale ler o que a skill faz antes de instalar.

  • Gen Agent Trust HubPassou
  • SocketPassou
  • SnykPassou

Perguntas

Como instalar a Spec Driven Development no Claude Code?

Toca em Levar, aqui nesta página, e deixa seu nome, e-mail e WhatsApp (é uma vez só). Aparece uma frase pronta: cola ela no Claude Code, que ele mesmo instala a Spec Driven Development, e a skill passa a valer na próxima conversa. A mesma frase serve no Codex. Se preferir fazer na mão, o passo a passo está em como instalar skills no Claude Code.

Serve pra quem não é programador?

Serve, porque o trabalho dela é perguntar e escrever em texto o que vai ser construído antes do código, e você aprova ou corrige. Parte da spec é técnica (comandos, estilo de código, testes); o que mais vale você conferir é o objetivo e os critérios de pronto. Pra correção de uma linha ou erro de digitação, a própria skill diz que não vale usar.

Precisa de alguma conta ou ferramenta?

Não. Sem chave de API e sem serviço pago. Ela cita outras skills do mesmo repositório (planning-and-task-breakdown, incremental-implementation e test-driven-development) pras fases de plano e execução, então rende mais com o pacote do Addy Osmani instalado.

Roda no Codex e no Antigravity?

Sim, é texto em Markdown e instala nos dois pelo npx skills add. Se o projeto já usa outro sistema de especificação, como o OpenSpec, ela mantém o formato dele em vez de criar um SPEC.md duplicado.

Levar essa skill

1x spec-driven-developmentR$ 0,00

TotalR$ 0,00

A skill sai aqui mesmo, na hora. Seus dados eu uso pra falar com você sobre o MazyOS.

Levar precisa do JavaScript ligado. O código da skill está no GitHub: github.com/addyosmani/agent-skills

Aprenda a usar

Mais da loja addyosmani

Ver a loja addyosmani