Branch, commit, PR

Branch

Cópia paralela do main onde você mexe sem afetar ninguém. Só existe na sua máquina até você fazer push.

Criar

git checkout -b <tipo>/<slug-curto>

Nomear

Formato: <tipo>/<descrição-curta-em-kebab-case>

Tipo	Pra quê
feat	nova funcionalidade
fix	correção de bug
refactor	melhoria de código sem mudar comportamento
docs	só documentação
chore	tarefa de manutenção (deps, build, etc)
migrate	migração de material legado pro repo
wip	work in progress (evite se possível)

Vida curta

Quanto mais tempo a branch vive, mais ela diverge do main → mais conflito quando for mergear.

Regra: branch não deve viver mais que 3 dias. Se tá ficando grande, quebra em sub-branches/sub-PRs.

Commit

“Foto” do estado do teu working directory, com legenda explicando o que mudou.

Criar

git add <arquivos>        # ou: git add .
git commit -m "mensagem"

Escrever boa mensagem

Regra simples: “se eu ler essa mensagem daqui 3 meses, eu entendo o que mudou sem abrir o código?”

❌ Ruim	✅ Boa
"ajuste"	"corrige typo no nome do cliente no briefing template"
"várias coisas"	"adiciona endpoint /api/leads + validação"
"wip"	"draft inicial da lógica de SDR cadence"

Tamanho ideal

• 1 commit = 1 mudança lógica. Não misture fix de bug com feature nova.
• Se a mensagem precisa de “e também” ou “mais”, provavelmente eram 2 commits.

Pull Request (PR)

Pedido formal pra mergear sua branch no main. É onde acontece a revisão.

Abrir

git push origin <branch>
gh pr create --title "Título curto" --body "Descrição detalhada"

Ou pelo browser — depois do git push, o Git mostra um link pra abrir PR.

Escrever descrição de PR

Template padrão:

## O que é
<1-2 linhas: o que esse PR entrega>

## Por que
<motivação: bug, feature request, migration, etc>

## Como testar
<passos pra revisor validar manualmente>

## Screenshots (se aplicável)
<drag & drop imagens>

## Pendências
<o que falta ou o que mudou de escopo no meio do caminho>

Tamanho ideal

• < 200 linhas: revisar é fácil. Aprovação rápida.
• 200-500 linhas: dá pra revisar, mas leva tempo.
• > 500 linhas: avisar Fred antes — PR gigante = revisão lenta = você fica bloqueado.

Review

Fred revisa na janela 9h-10h. Pode:

• ✅ Aprovar e fazer merge
• 💬 Comentar pedindo ajuste
• 🔄 Pedir mudanças com resumo do que falta

Depois do merge

git checkout main
git pull
git branch -d <sua-branch>    # apaga branch local

A branch remota é deletada automaticamente se você habilitou no repo.

Próximo

→ Ritmo do time — horários de push e review.