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
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.
Consultar
specsfy --versionMostra a versão do executável.
Atualizar a CLI
specsfy upgradeTroca o executável pela release publicada.
Atualizar o projeto
specsfy update --project .Atualiza o framework no app indicado.
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.