Pular para o conteúdo
ReviewRamble

A newsletter semanal

IA, analisada, na sua caixa de entrada.

  • Novas análises de ferramentas, modelos, servidores MCP e repositórios, com o veredicto logo no início
  • Preços e notas reconferidos quando algo muda
  • Novos artigos de análise assim que são publicados

Modelos, agentes, servidores MCP e as ferramentas que realmente valem seu tempo.

Um e-mail por semana. Cancele pelo link em qualquer edição. Como usamos seu e-mail

ZeeSpec

Um método de 60 perguntas, um CLI e um app de navegador para escrever specs que agentes não consigam interpretar mal, com nota EPIC e bancada SpecGuard.

Análise de ReviewRamble editors · Atualizado

Ver no GitHub Código aberto

Compartilhe esta página:XLinkedInFacebookRedditWhatsAppE-mail

Nossa nota

3.3/5

As perguntas do ZeeSpec são um checklist sólido e a aba SpecGuard é uma pequena ferramenta didática afiada, mas a linha de instalação do CLI aponta para o pacote de outra pessoa.

O que é ZeeSpec?

O ZeeSpec é o método de Vishal Mysore para desenvolvimento guiado por especificação: 60 perguntas em seis grupos (o quê, onde, quando, quem, por quê, como), dez em cada, pensadas para serem respondidas em cerca de uma hora, para que não sobre ao agente nenhum comportamento indefinido para adivinhar. Um pequeno CLI em Node.js gera oito modelos em Markdown em uma pasta .spec/, junta tudo em um AGENTS.md e copia o prompt para a área de transferência.

O app de navegador em vishalmysore.github.io/zeespec/app tem três abas. Spec Builder percorre as perguntas e pode rascunhar o AGENTS.md com um modelo local em WebGPU. EPIC Score dá nota a uma spec, a um repositório público do GitHub ou a um texto colado segundo uma versão heurística da rubrica EPIC de um artigo do arXiv de outubro de 2026: 40 práticas em 10 dimensões, com nota até 30. SpecGuard recria o SpecGuardBench em miniatura: 16 tarefas em JavaScript que testam se o harness de validação de um modelo rejeita uma implementação com bug e aceita duas corretas. O repositório tem 14 commits e nenhuma release; o último commit foi em 16 de novembro de 2026.

ZeeSpec vale a pena?

A ideia útil aqui é a aba SpecGuard, não o método. Ela mostra, no navegador e sem GPU, a falha que um artigo chamado SpecGuardBench documenta: peça a um modelo que escreva testes a partir de uma implementação de referência e ele espelha a referência, bugs incluídos. Das três linhas de base embutidas, espelhar a referência tem 0% de fidelidade, repetir o teste existente tem 0%, e só um oráculo escrito à mão chega a 100%. Cada harness roda em um worker sem rede e com limite de tempo, e dá para editar e rodar de novo. Como demonstração de por que testes escritos por agentes aprovam bugs, é mais clara do que a maior parte dos textos sobre o assunto.

A aba EPIC Score é mais modesta do que o selo sugere. É uma reimplementação heurística da rubrica do artigo, não a ferramenta dos autores, e o app diz isso; a constatação do artigo de que specs da faixa de cima gastaram 11,8% dos commits em correções de bugs, contra 20,4% da faixa de baixo, é uma correlação em 114 repositórios.

As 60 perguntas são boas perguntas, do tipo que um tech lead cuidadoso faz: o que nunca deve ser armazenado, quem nunca deve agir, quando o sistema deve bloquear. A promessa de uma hora é relativizada pelo próprio aviso do projeto.

O porém: o comando de instalação do README, `npx spec-cli init`, baixa um pacote npm sem relação chamado spec-cli, publicado por outro autor em 2024 e apontando para outro repositório; o ZeeSpec em si não está no npm. Rodá-lo executa o código de um estranho. Clone o repositório e rode bin/spec.js no lugar. O projeto tem 18 estrelas e 14 commits.

Nossa opinião: trate o ZeeSpec como uma planilha de trabalho e uma demonstração de aula. O Spec Kit do GitHub é a ferramenta de produção para o mesmo trabalho.

Onde ele se destaca

  • Uma gerente de engenharia conduzindo um workshop interno sobre testes escritos por agentes

    Mostrar aos desenvolvedores por que testes gerados a partir do código deixam passar os bugs desse código

    Abra a aba SpecGuard, ative o modo mirror trap e rode as três linhas de base ao vivo: o oráculo tem 100% de fidelidade, as outras duas 0%. Gratuito, nada para instalar, e cada harness roda isolado no navegador.

  • Um desenvolvedor solo começando um pequeno app de reservas com Claude Code

    Escrever uma spec completa o bastante para o agente parar de inventar regras

    Percorra as 60 perguntas no Spec Builder, exporte o AGENTS.md, confira na aba EPIC Score e cole o prompt de correção no agente. Para o CLI, clone o repositório em vez de usar npx.

Antes de decidir

Configuração
Abra o app web em um navegador com WebGPU para o modelo local, ou clone o repositório e rode `node bin/spec.js init`. Não rode `npx spec-cli`: esse nome no npm pertence a um pacote sem relação.
Integrações
Gera AGENTS.md para qualquer agente que o leia; o EPIC Score lê estruturas de Spec Kit, Kiro, ZeeSpec e AGENTS.md em repositórios públicos do GitHub; WebLLM para o modelo local opcional.
Dados e privacidade
O app afirma que nada sai do seu navegador; o download do modelo e as leituras de repositórios do GitHub são o único tráfego de rede. Os harnesses do SpecGuard rodam em workers sem rede. Licença MIT.
Limites
O SpecGuard tem 16 tarefas em JavaScript contra as 291 tarefas em Python do artigo, então as notas não são comparáveis; a nota EPIC é heurística; sem pacote no npm nem releases com tag.

O que é bom

  • SpecGuard demonstra com clareza a falha dos testes espelhados
  • App de navegador roda localmente, com workers de teste sem rede
  • 60 perguntas concretas que expõem comportamento indefinido
  • Honesto sobre a nota heurística e seus limites

O que não é

  • O comando npx do README instala um pacote npm sem relação
  • A nota EPIC é uma heurística, não a ferramenta do artigo
  • Projeto minúsculo: 18 estrelas, 14 commits, sem releases
  • Download do modelo local de cerca de 1 a 2 GB

Ideal para

Tech leads e professores que querem um checklist estruturado de specs e uma demonstração vívida de como agentes escrevem testes que deixam bugs passar.

Alternativas ao ZeeSpec

ZeeSpec: perguntas frequentes

ZeeSpec vale a pena?
As perguntas do ZeeSpec são um checklist sólido e a aba SpecGuard é uma pequena ferramenta didática afiada, mas a linha de instalação do CLI aponta para o pacote de outra pessoa. Damos nota 3.3 de 5.
Quanto custa ZeeSpec?
Gratuito e open source (MIT). O app web roda no seu navegador; o modelo local opcional é baixado uma vez, com cerca de 1 a 2 GB.
Quais são as desvantagens de ZeeSpec?
O comando npx do README instala um pacote npm sem relação; a nota EPIC é uma heurística, não a ferramenta do artigo; projeto minúsculo: 18 estrelas, 14 commits, sem releases; download do modelo local de cerca de 1 a 2 GB.
Para quem ZeeSpec é indicado?
Tech leads e professores que querem um checklist estruturado de specs e uma demonstração vívida de como agentes escrevem testes que deixam bugs passar.
ZeeSpec é seguro para dados da empresa?
O app afirma que nada sai do seu navegador; o download do modelo e as leituras de repositórios do GitHub são o único tráfego de rede. Os harnesses do SpecGuard rodam em workers sem rede. Licença MIT.
Quais são as melhores alternativas ao ZeeSpec?
As alternativas mais próximas que analisamos são Spec Kit e Agent Skills (Addy Osmani).

Respostas verificadas em 21 de nov. de 2026.