Resumo
O Specsfy 0.40.0 acrescenta seis especialistas e leva a sugestão para o CLI. Entram mcp, mysql, mongodb, cloudflare, n8n e testing, e cada um chega com os modos que a stack do projeto pede: o mcp cobre protocol, laravel e nextjs, enquanto o testing organiza pest, playwright e vitest. O laravel ganha o modo mcp, o docker ganha o modo proxy com Traefik, e o delivery ganha a referência de GitHub Actions no modo ci-cd. Com a tabela de sinais, a spec de um projeto Laravel que expõe servidor MCP chega ao plano com especialista e modo já indicados, sem escolha manual entre 21 nomes.
A segunda frente é de sugestão e de conferência. O specsfy specialists suggest <spec>, também skills suggest, e a ferramenta MCP specialists_suggest leem a spec, procuram os sinais do catálogo e listam especialista e modo sugeridos, com a indicação de declarado e de instalado. O specsfy verify avisa quando a spec declara especialista inexistente ou não instalado e quando um sinal casado fica sem especialista declarado.
A terceira frente é de catálogo e de revisão do conteúdo. Os sinais vivem agora no catalog.json, em triggers e modes, e as sete tabelas de sinais das skills base são geradas pelo scripts/specialist-signals.mjs. Os 21 especialistas são revisados contra a documentação oficial atual, com React 19.3, Next.js 16.4, TypeScript 7, Tailwind CSS 4.3, PostgreSQL 19, Redis 8.10, OWASP Top 10:2025, ASVS 5.0 e OpenAPI 3.2.1.
Novidades
- Specsfy 0.40.0 — Especialista
mcp: o especialista cobre servidor MCP por HTTP, com os modosprotocol,laravelpara o pacotelaravel/mcpenextjs. - Specsfy 0.40.0 — Especialistas
mysqlemongodb: cada um traz os modos de modelagem, de consulta e de operação. - Specsfy 0.40.0 — Especialistas
cloudflareen8n: ocloudflarecobre DNS, Workers e segurança, e on8ncobre fluxo, auto-hospedagem e integração. - Specsfy 0.40.0 — Especialista
testing: os modospest,playwrightevitestorganizam o teste por pilha do projeto. - Specsfy 0.40.0 —
specsfy specialists suggest: o comando lê a spec, procura os sinais do catálogo e lista especialista e modo sugeridos, com a indicação de declarado e de instalado. A ferramenta MCPspecialists_suggestexpõe a mesma leitura. - Specsfy 0.40.0 — Aviso no
specsfy verify: a verificação avisa quando a spec declara especialista que não existe ou não está instalado, e quando um sinal casado fica sem especialista declarado. - Specsfy 0.40.0 — Linha
Especialistasna prévia da TUI: a prévia da spec mostra a lista de especialistas declarados.
Melhorias
- Specsfy 0.40.0 — Sinais no
catalog.json:triggersguarda sinal, modo e palavras-chave, emodesguarda nome, título da seção no guia e o especialista antigo absorvido. As sete tabelas de sinais são geradas peloscripts/specialist-signals.mjs, e um teste reprova cópia divergente. - Specsfy 0.40.0 — Sinais novos: entram validade, cota de uso, valor monetário, papel por grupo e CRUD parcial. O
postgrese osupabasesó entram com a tecnologia confirmada noSTACK.md. - Specsfy 0.40.0 — Especialista de tecnologia condicionado à stack: um especialista de tecnologia só aparece quando a stack do projeto confirma, pela detecção do catálogo ou pelo
.specsfy/STACK.md. - Specsfy 0.40.0 — Revisão contra a documentação oficial: os 21 especialistas são atualizados com React 19.3, Next.js 16.4, TypeScript 7, Tailwind CSS 4.3, shadcn CLI v4, PostgreSQL 19, Redis 8.10, OWASP Top 10:2025, ASVS 5.0 e OpenAPI 3.2.1.
- Specsfy 0.40.0 — Escolha delegada e fase do especialista: entra um protocolo para escolhas delegadas, e a seção “No Specsfy” diz de onde o especialista lê em cada fase.
- Specsfy 0.40.0 — Pendência de stack em vez de parada no setup: Octane com Open Swoole e ReUI ausentes viram pendência de stack, cobrada antes de publicar, em vez de travar a configuração.
- Specsfy 0.40.0 —
specs transitionmantém o vínculo: a transição atualiza o vínculo “Spec promovida” no backlog. - Specsfy 0.40.0 — 301 por modo no site: os 301 dos especialistas agrupados apontam para a seção do modo, como
/docs/specsfy/especialistas/delivery/#versionamento.
Correções
- Specsfy 0.40.0 — Raiz do projeto sem
.git: os gates encontram a raiz do projeto mesmo sem repositório Git. - Specsfy 0.40.0 — Teste de regressão e TDD: um teste de regressão não vale mais como TDD.
- Specsfy 0.40.0 — Contrato CRUD com operações declaradas: o contrato declara as
Operações:incluídas, e o validador cobra apenas essas. - Specsfy 0.40.0 — Research com índice vazio: o research aceita índice vazio quando a spec declara que não usa fonte externa.
- Specsfy 0.40.0 —
05-taskse lista de especialistas: a fase pode atualizar a lista de especialistas da spec.
Ponto de Atenção
A sugestão de especialista depende de sinal na spec e de stack confirmada. Um projeto que descreve a tecnologia só no texto, sem STACK.md nem detecção pelo catálogo, recebe menos sugestão do que espera, porque o especialista de tecnologia não entra sem confirmação. O specsfy verify avisa agora sobre declaração inconsistente, e o aviso não impede sozinho a transição.
A revisão dos 21 especialistas muda referência de versão dentro dos guias. Um projeto que copiou trecho de guia para o próprio documento mantém o texto antigo até revisar.
Teste sugerido: rode specsfy specialists suggest numa spec de projeto Laravel com STACK.md e confira o modo sugerido e a indicação de instalado. Retire o STACK.md e repita o comando para ver a diferença, depois declare um especialista inexistente na spec e rode specsfy verify. Abra a prévia da TUI para conferir a linha Especialistas e rode npm run signals com o teste que compara as tabelas geradas.
Notas da versão
O release oficial do Specsfy 0.40.0 foi publicado em 21/11/2026 como versão estável. As notas vêm do anúncio da publicação, com blocos de adição e de alteração, e citam as versões de referência usadas na revisão dos especialistas.