Digite para filtrar os verbetes do Glossário.

    Git e qualidade · Vibe Coding: Do Zero ao MVP

    O que é SemVer?

    O SemVer indica como uma versão altera a API pública. A numeração distingue correções compatíveis, novas funções e mudanças que exigem adaptação no uso.

    Também chamado de: Semantic Versioning, versionamento semântico

    StayCloudVPS Agêntica

    Uma VPS para os seus agentes trabalharem dia e noite

    Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

    Montar minha VPS Agêntica

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    Compatibilidade na numeração

    O SemVer é uma convenção para indicar, no número de uma versão, como as alterações afetam a API pública (interface de programação de aplicações). Essa interface é o conjunto de funções e comportamentos que o projeto declara disponíveis para outros programas usarem. A compatibilidade depende desse contrato declarado.

    O formato MAJOR.MINOR.PATCH separa a versão em três números. A partir de 1.0.0, o terceiro aumenta com correções compatíveis, enquanto a inclusão de uma função pública compatível aumenta o segundo e zera o terceiro. Alterações incompatíveis exigem aumentar o primeiro número e zerar os outros dois.

    Quando uma função exige outro argumento

    Neste exemplo didático, uma biblioteca na versão 2.4.1 oferece enviarEmail(destinatario). A próxima versão exige também o assunto, sem aceitar as chamadas antigas. Como o argumento adicional é obrigatório, os programas que usam a função precisam de adaptação. Essa alteração corresponde a 3.0.0.

    Uma correção interna compatível corresponderia a 2.4.2. Já uma função pública adicional que preservasse o uso existente corresponderia a 2.5.0. Você classifica a alteração pelo efeito no contrato, mesmo quando a mudança ocupa poucas linhas.

    Pré-lançamentos e versões iniciais

    A série 0.y.z indica desenvolvimento inicial e não pressupõe uma API estável. O identificador 3.0.0-rc.1 marca um pré-lançamento com precedência inferior a 3.0.0. Já os metadados após +, como em 3.0.0+build.7, não alteram a precedência.

    Uma versão publicada deve conservar seu conteúdo. O número informa o compromisso de compatibilidade assumido pelo projeto, mas você ainda precisa consultar as notas da versão para identificar as adaptações exigidas na aplicação.

    Dúvidas frequentes

    Perguntas frequentes sobre SemVer

    O que define a API pública de um projeto?
    O projeto declara, no código ou na documentação, as funções e os comportamentos disponíveis para outros programas usarem. O SemVer classifica a compatibilidade em relação a essa interface.
    A série 0.x tem o mesmo compromisso de compatibilidade?
    A especificação reserva 0.y.z ao desenvolvimento inicial e permite mudanças na API pública. Você precisa consultar a documentação do projeto para avaliar uma atualização nessa série.
    É permitido corrigir o conteúdo de uma versão já publicada?
    Uma versão publicada deve permanecer inalterada. Até uma correção pequena precisa receber outro número de versão, para que a mesma identificação continue apontando para o mesmo conteúdo.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    O desenvolvimento com agentes exige compreender o comportamento da aplicação e conferir o resultado das alterações.

    Conhecer a formação
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano