AEX Engineering
Standards

Padrão Oficial de Branches

Um padrão de branches simples e previsível. O nome diz a intenção.

1 min de leitura

Um padrão de branches simples e previsível. O nome diz a intenção.


Branches permanentes

BranchFunção
mainCódigo em produção. Sempre estável.
developIntegração contínua do time.

Branches de trabalho

Toda branch de trabalho parte de um prefixo que declara sua intenção, seguido de uma descrição curta em kebab-case.

PrefixoFunçãoExemplo
feature/Nova funcionalidade.feature/checkout
fix/Correção de bug.fix/login-erro
hotfix/Correção urgente em produção.hotfix/pagamento
release/Preparação de uma versão.release/v1.2.0

Nomenclatura:

  • Use kebab-case após o prefixo (feature/historico-transacoes).
  • Seja descritivo e curto — o nome diz o que a branch faz.
  • Sem espaços, acentos ou maiúsculas.

Fluxo

  • feature/ e fix/ nascem de develop e voltam para develop via Pull Request.
  • release/ nasce de develop para preparar uma versão e é publicada em main.
  • hotfix/ nasce de main para uma correção urgente, volta para main e também é levada de volta a develop.
  • Todo merge passa por Pull Request e pelo checklist de code review.

Regras (resumo)

  1. main está sempre estável — só recebe código pronto para produção.
  2. Toda branch de trabalho usa um prefixo de intenção (feature/, fix/, hotfix/, release/).
  3. Nomes em kebab-case, curtos e descritivos.
  4. Nada é mesclado sem Pull Request e review.
  5. Commits seguem o COMMIT_STANDARD; a publicação segue o DEPLOY_STANDARD.

On this page