Ir para o conteúdo
Promovaweb

Versões do Specsfy e changelog

As versões do Specsfy identificam as publicações da CLI e do framework usado no projeto. O comando upgrade atualiza o executável, enquanto update atualiza as skills, os templates e os blocos gerenciados no app indicado.

Referência técnica
Specsfy v0.29.1
Revisão
14 de novembro de 2026
Conteúdo
Documentação oficial consultada
  1. O programa instalado e o framework do projeto
  2. Binário direto e distribuição pelo npm
  3. O que as notas de versão explicam
  4. Alterações locais durante uma atualização
  5. Conferir a referência utilizada

O programa instalado e o framework do projeto

O executável specsfy é o programa que responde no terminal. Ele oferece os comandos da CLI e abre a interface de terminal. O framework instalado no repositório do seu app reúne as skills e os templates usados durante o desenvolvimento. As duas partes têm relação com a versão publicada, mas uma atualização precisa identificar qual delas será alterada.

Você consulta a versão do programa com specsfy --version, que identifica o executável em uso naquele terminal. As skills instaladas pertencem a cada projeto e recebem atualização própria. Por isso, a resposta da CLI precisa ser lida junto da situação do app que você pretende atualizar. Esse projeto pode ter customizações locais a preservar durante a manutenção, mesmo quando o programa já utiliza a release mais recente.

O comando specsfy upgrade atualiza o próprio executável. O comando specsfy update --project . atualiza o framework do projeto indicado. Essa diferença explica por que instalar uma CLI nova não equivale a revisar automaticamente os arquivos de todos os apps que você desenvolve na máquina. O destino da atualização faz parte da ação escolhida.

  1. Consultar

    specsfy --version

    Mostra a versão do executável.

  2. Atualizar a CLI

    specsfy upgrade

    Troca o executável pela release publicada.

  3. Atualizar o projeto

    specsfy update --project .

    Atualiza o framework no app indicado.

A atualização do executável e a atualização do framework atingem destinos diferentes. A versão consultada no terminal identifica a CLI em uso.

Binário direto e distribuição pelo npm

A v0.29.1 utiliza um binário compilado em Bun com runtime embutido. O download direto disponibiliza esse executável para a plataforma correspondente. O programa não depende de uma instalação separada de Node.js ou Bun para rodar. Essa característica descreve a CLI, sem alterar os requisitos da stack do app que ela acompanha.

O pacote @promovaweb/specsfy distribuído pelo npm funciona como um wrapper. Na primeira execução, ele baixa o binário adequado ao sistema operacional. O npm participa desse caminho de instalação, enquanto o executável baixado contém o runtime utilizado pelo Specsfy. Os dois meios de distribuição levam ao programa documentado na release.

Você também encontra a TUI no mesmo executável para acompanhar as especificações e o progresso no terminal. Se utilizar um cliente compatível, o servidor MCP disponibiliza ações do programa sobre os arquivos do projeto. As duas interfaces consultam a mesma spec, então a definição da funcionalidade continua no documento que acompanha o código. Uma mudança feita por uma delas precisa aparecer nesse arquivo para orientar o trabalho seguinte.

O que as notas de versão explicam

As releases oficiais registram as alterações de cada publicação. A v0.29.1 publica os três capítulos acrescentados ao guia na v0.29.0: casos de uso, exemplos completos e referência rápida. Eles também fazem parte do ebook. A versão de referência deste portal é a v0.29.1, consultada em 14 de novembro de 2026.

A v0.29.0 não gerou GitHub Release porque a descrição OpenCLI ainda declarava a versão anterior. A v0.29.1 corrige esse arquivo e publica o conteúdo previsto para a 0.29.0. Você recebe novos capítulos para consultar o método, com o fluxo de especificação preservado. O código da aplicação continua seguindo a especificação e os testes do seu próprio projeto.

O changelog do Specsfy na Promovaweb reúne os artigos disponíveis sobre as versões. A linha do tempo do portal utiliza esse mesmo feed. A presença de uma release no GitHub e a disponibilidade de um artigo no feed são registros diferentes. A lista editorial mostra somente as entradas que já existem na coleção do website.

Alterações locais durante uma atualização

O framework mantém um registro das skills gerenciadas e do conteúdo instalado. Quando encontra uma alteração local, a CLI recusa a atualização ou a remoção da skill. A opção --force permite descartar a customização, por isso seu uso exige conferir o conteúdo que será substituído. Os templates em .specsfy/templates/custom/ permanecem protegidos mesmo com essa opção.

Os templates personalizados têm um diretório próprio em .specsfy/templates/custom/. Eles recebem precedência sobre os templates padrão com o mesmo nome. Essa separação permite reconhecer o que pertence à instalação do framework e o que foi adaptado para o projeto. A documentação da CLI descreve o tratamento desses arquivos durante atualização e remoção.

Você confere a compatibilidade da mudança com os comandos e os documentos que utiliza. Uma spec em andamento pode depender de um contrato que recebeu ajustes na nova versão. A leitura das notas e a verificação do projeto ajudam a identificar essa diferença sem reescrever o histórico de uma mudança já concluída.

Conferir a referência utilizada

Cada página do portal registra a versão consultada e as fontes datadas. Essa ficha permite distinguir uma explicação baseada na v0.29.1 de uma referência posterior. Os comandos completos e suas opções ficam na documentação do Specsfy, que mantém o percurso de instalação e a referência de uso do programa.

A Formação Vibe Coding relaciona esse uso ao desenvolvimento com agentes. Para acompanhar escolhas técnicas recorrentes do seu app, o Conselheiro de Tecnologia da Dev Side Studio oferece continuidade à revisão de arquitetura e manutenção. As notas oficiais permanecem a fonte para identificar o que a versão do Specsfy altera.

Converse na comunidade

Leve ao Discord da Promovaweb o comportamento que você quer descrever e a dúvida sobre o teste correspondente. A comunidade pode discutir essa relação antes da implementação.

Desenvolva com IA

A documentação explica os comandos do Specsfy. A Formação Vibe Coding acompanha o aprendizado de desenvolvimento com IA.

Para organizar o escopo e a arquitetura do seu app, conheça o Diagnóstico de Produto e Arquitetura da Dev Side Studio.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.