Pular para o conteúdo
Voltar para o blog
  • workflow de desenvolvimento
  • Arquitetura de Software
  • Projetos Pessoais
  • TDD
  • qualidade de software

Git Flow para GitHub Flow

Por Que Não Ficamos no Trunk-Based Development

Pixel art noturno: num pátio ferroviário, um trem verde-limão num desvio curto volta para a linha principal roxa

Faz algum tempo que comecei a considerar abrir minha própria empresa de tecnologia. E percebi rápido que escrever bom código não basta para sustentar um negócio. Faltava entender o que cerca o software: infraestrutura, cloud e o processo que leva o código da minha máquina até produção. Foi assim que cheguei ao Trunk-Based Development como possível solução. E foi tentando implementá-lo que descobri que o fluxo que eu uso é outro: o GitHub Flow. Neste post eu conto por que saí do Git Flow, por que não fiquei no Trunk-Based Development e como é a minha rotina hoje.

Além das Features: Por Que Fui Estudar Infraestrutura e Workflow de Git

Tenho formação em Administração e Gestão de TI, então a parte de gestão nunca foi o meu ponto fraco. Arquitetura de software também não, porque trabalho com desenvolvimento há anos e contribuo com projetos open source. O que faltava era outra coisa: as frentes que não aparecem no código da aplicação, mas que decidem se um produto sobrevive em produção.

Comecei estudando cloud computing. De lá, cheguei ao versionamento e ao workflow de Git como a próxima peça. Não foi falta de confiança técnica. Foi uma ampliação de escopo com um objetivo concreto: se um dia eu tocar a minha própria startup, preciso entender não só como construir o produto, mas como o time entrega esse produto de forma contínua e confiável.

Foi aí que o Trunk-Based Development entrou na pesquisa. Não como moda, mas como resposta a uma pergunta prática: como os times de alta performance organizam a entrega de código? Antes de chegar nele, porém, eu precisava resolver o que já não funcionava.

Por Que o Git Flow Parou de Fazer Sentido nos Meus Projetos Pessoais

Muitos posts sobre o assunto simplificam este ponto. Eu não saí do Git Flow por achar que ele é ruim. Saí porque ele deixou de servir ao contexto em que eu estava usando.

O Git Flow foi criado por Vincent Driessen em 2010. Ele tem duas branches permanentes (master e develop) e branches de apoio para feature, release e hotfix. Foi desenhado para software versionado, que precisa manter várias versões em produção ao mesmo tempo. O próprio Driessen, numa nota adicionada anos depois ao post original, reconheceu isso e passou a recomendar fluxos mais simples para times que praticam entrega contínua.

Como o Git Flow chegou aos meus projetos

Não foi por uma análise cuidadosa. Foi por hábito. Quando entrei na empresa onde trabalho hoje, não existia um fluxo de Git estruturado. A equipe era ágil para integrar e entregar, mas ainda não tinha processos formais para sustentar um trunk sempre saudável.

Fui atrás de uma solução para aquele caos específico. Estudei o Git Flow a fundo, entendi as vantagens e as desvantagens na prática e implementei o fluxo na empresa. Para aquele contexto, funcionou.

O problema de copiar o fluxo para outro contexto

O erro foi levar a mesma estrutura para os meus projetos pessoais, só porque era o que eu já dominava. Ali eu trabalhava sozinho, com a disciplina técnica que sei que tenho, e o Git Flow virou só processo no meio do caminho. Eu queria agilidade, e as branches de develop, release e hotfix criavam um atrito que nenhum benefício justificava num time de uma pessoa.

Foi esse atrito que me fez procurar uma alternativa. A primeira que encontrei, ainda na pesquisa, foi o Trunk-Based Development.

O Que É Trunk-Based Development (e Por Que Me Deixou Inseguro)

Trunk-Based Development (TBD) é um modelo de branching em que o time colabora numa única branch principal, o trunk (geralmente main), e evita branches de longa duração. Paul Hammant, referência no tema, resume assim: os desenvolvedores colaboram numa única branch chamada trunk e resistem a qualquer pressão para criar outras branches de desenvolvimento de vida longa. Fazer merge no trunk pelo menos uma vez por dia é o que a própria comunidade chama de key enabler da Integração Contínua.

A DORA (DevOps Research and Assessment, hoje parte do Google Cloud) define três sinais de que o TBD está saudável:

  • três ou menos branches ativas no repositório;
  • merge no trunk pelo menos uma vez por dia;
  • nenhum code freeze nem fase de integração dedicada.

A pesquisa da DORA associa o TBD aos times de alta performance de entrega. Uma ressalva: circulam em blogs números de "quantas vezes mais propensos" os times de elite são a usar TBD, mas não encontrei essa cifra no material primário da DORA. Por isso não repito o número. O que está confirmado é a correlação: TBD é a prática de branching dos times que entregam com mais frequência e menos atrito.

Decidi migrar com entusiasmo. Mas, quanto mais eu lia sobre a prática canônica, com integração rápida no trunk e o mínimo de cerimônia, mais aquilo me parecia arriscado, mesmo com testes e CI. Eu queria a agilidade do TBD, mas também queria uma camada formal de segurança antes de qualquer coisa tocar a branch principal. E essa camada, descobri depois, eu já tinha.

A Descoberta: Ao Implementar TBD, Percebi que Uso GitHub Flow

Foi só ao revisar o que eu estava praticando que percebi o erro de nomenclatura. Eu achava que estava aplicando TBD, mas o que eu uso é GitHub Flow. A documentação oficial do GitHub define o fluxo em seis passos:

  1. criar uma branch;
  2. fazer as alterações;
  3. abrir um pull request;
  4. responder aos comentários de revisão;
  5. fazer o merge do pull request;
  6. apagar a branch.

O ponto central é que as mudanças não chegam à branch padrão até o merge. Ou seja, a branch principal só recebe código depois que o pull request é revisado e aprovado.

A diferença entre GitHub Flow e TBD

Segundo uma comparação técnica que encontrei na pesquisa, a diferença não está no tempo de vida das branches, porque os dois usam branches de feature curtas. Está na exigência de revisão. O GitHub Flow exige o pull request como mecanismo formal antes da integração. O TBD "puro" prioriza o merge rápido no trunk, com o mínimo de cerimônia. Foi exatamente esse detalhe que resolveu a minha insegurança.

A documentação do GitHub trata essa revisão como prática institucionalizada, não como formalidade:

"Pull request review is so valuable that some repositories require an approving review before pull requests can be merged."

Em português: a revisão de pull request é tão valiosa que alguns repositórios exigem uma aprovação antes de permitir o merge.

Comparado ao Git Flow, o GitHub Flow também elimina as várias branches permanentes. Fica uma branch de produção e branches de feature temporárias, criadas para uma única mudança e apagadas depois do merge.

Eu vejo o GitHub Flow como parte da mesma família de práticas de entrega contínua do TBD, com uma engrenagem extra de segurança. E essa engrenagem combina com o meu perfil: confio na minha disciplina técnica, mas prefiro que o meu código seja revisado antes de tocar o trunk, mesmo quando o revisor sou eu em outro momento ou uma IA que uso no processo. Se quiser ver como a IA entra nesse processo, escrevi sobre isso em meu fluxo de desenvolvimento com IA.

Minha Rotina com GitHub Flow: PR Obrigatório, Branches Curtas, Deploy Contínuo

Hoje uso GitHub Flow tanto em projetos pessoais quanto em projetos comerciais de clientes. Na prática, isso significa:

  • uma branch curta para cada mudança;
  • pull requests pequenos e frequentes;
  • a branch principal pronta para deploy assim que um PR entra.

O que eu ainda não usei: feature flags

Ainda não usei feature flags na prática. Elas estão mais ligadas ao TBD puro, para lidar com trabalho incompleto que precisa entrar no trunk antes de estar pronto para os usuários. Martin Fowler e Pete Hodgson descrevem os feature toggles como uma técnica poderosa, que permite ao time mudar o comportamento do sistema sem alterar o código.

Como no GitHub Flow o PR só entra quando a mudança está pronta para revisão, eu não tive a necessidade de fazer merge de algo incompleto. Mesmo assim, é um ponto que preciso experimentar para entender as implicações na prática, e não só na teoria.

Nenhuma dessas práticas se sustenta sozinha, porém. Elas dependem de guardrails.

Disciplina Como Pré-Requisito: Testes, CI e Guardrails

O primeiro guardrail, e o mais importante para mim, eu já praticava antes de pesquisar TBD ou GitHub Flow: testes unitários, de integração e de regressão em tudo que escrevo. Contei esse caminho em minha jornada com TDD.

Com o novo fluxo, esses testes deixaram de ser só disciplina de qualidade e viraram uma peça estrutural do processo. Qualquer erro grande que eu cometa quebra os testes e bloqueia o merge automaticamente no CI, antes mesmo de o PR ser aprovado.

Além do CI, os outros guardrails são de comportamento:

  • Nomenclatura de branches consistente, mesmo para branches que vivem poucas horas.
  • PRs pequenos, para evitar revisões grandes e demoradas.
  • Integração rápida, sem deixar trabalho acumulado fora da branch principal.

Se esse tipo de fluxo depende mais de disciplina ou do tamanho do time, eu prefiro deixar claro o limite do que sei. Não tenho experiência suficiente com times grandes para opinar com segurança sobre como TBD ou GitHub Flow se comportam nessa escala. O que posso afirmar, porque vivo isso, é que para times pequenos e disciplinados o modelo funciona muito bem.

E isso leva à pergunta oposta: quando não usar.

Trade-offs: Quando o Git Flow Ainda É a Escolha Certa

Reconhecer o limite do que aprendi também é reconhecer que o Git Flow continua excelente em certos contextos. Setores regulados, como bancos e fintechs, tendem a preferir fluxos mais controlados, com trilha de auditoria explícita, aprovações manuais e ambientes de promoção bem definidos entre desenvolvimento, staging e produção.

Fluxos mais enxutos como TBD e GitHub Flow dependem de boa cobertura de testes automatizados e de revisão ágil. Mesmo assim, um bug que passe pelos filtros automáticos chega perto da produção rapidamente. Esse perfil de risco nem sempre é compatível com exigências de compliance.

No fim, não é uma decisão só técnica. É uma decisão de liderança. Cada empresa tem o seu contexto, e cabe a quem lidera tecnicamente listar vantagens e desvantagens com base no conhecimento da empresa e do time, para então decidir o que faz mais sentido ali. Os modelos funcionam bem, cada um no lugar certo.

Conclusão

Eu saí do Git Flow porque ele virou atrito num contexto para o qual não foi feito. Fui atrás do Trunk-Based Development pela agilidade, e não fiquei nele porque queria uma revisão formal antes do merge. No caminho, descobri que essa combinação já tinha nome: GitHub Flow.

Se você está em dúvida entre Git Flow, GitHub Flow e Trunk-Based Development, meu conselho é testar. Comece por projetos pessoais ou de clientes de menor risco. Observe se o fluxo se sustenta com a disciplina que você e o seu time têm hoje, e não com a que gostariam de ter.

E, se na pesquisa você descobrir, como eu, que usa um fluxo diferente do que achava, tudo bem. O nome do fluxo importa menos do que entender por que ele funciona no seu contexto.

Referências

Matheus Mierzwa

AI Enablement Lead & Frontend Tech Lead

Escrevo sobre o que construo e lidero na prática.