Fluxos de Git e code review

Modelos de branching

• Trunk-based development: branches de vida curta (horas ou um dia ou dois) integrados com frequência à main, com feature flags escondendo o trabalho inacabado. Ideal para feedback rápido e entrega contínua.
• Feature branches com pull requests: o meio-termo comum. Mantenha os branches pequenos e curtos.
• Branches de release de longa duração (estilo Gitflow): úteis quando é preciso manter várias versões liberadas ao mesmo tempo; mais lentos e com mais trabalho de merge.
• Seja qual for o modelo, a main deve estar sempre pronta para release, e toda mudança chega a ela por um pull request revisado.

O que é um bom pull request

• Pequeno: um revisor o entende em minutos. Mudanças grandes escondem erros.
• Um único propósito, com uma descrição do porquê, e não só do quê.
• CI verde antes de a revisão começar, para que as pessoas gastem tempo com design e risco, não com erros de digitação.
• Revisado por quem é dono da área: o CODEOWNERS automatiza o pedido.
• Integrado com um histórico claro (squash ou rebase merge), de modo que um revert seja um único comando.

Torne as regras automáticas

# vale o último padrão que corresponder
*                    @example/engineering
/infra/              @example/platform
/.github/workflows/  @example/platform @example/security
/src/auth/           @example/security

gh api -X PUT repos/example/app/branches/main/protection --input - <<'EOF'
{
  "required_status_checks": { "strict": true, "contexts": ["verify"] },
  "enforce_admins": true,
  "required_pull_request_reviews": { "required_approving_review_count": 1, "require_code_owner_reviews": true },
  "restrictions": null
}
EOF

Hábitos que compensam

• Faça commits cedo e com frequência no seu branch; limpe antes de integrar.
• Nunca reescreva o histórico de um branch compartilhado.
• Assine commits ou tags de releases quando a proveniência importar.
• Mantenha segredos fora do histórico: um segredo commitado uma vez precisa ser rotacionado, não apenas apagado.
• Reverta primeiro, investigue depois, quando a main quebrar.