Git Workflow - Boas Práticas

Esta skill implementa um workflow Git consistente para desenvolvimento em equipe.

Modelo de Branches

code

main (ou master)
  │
  ├── develop
  │     │
  │     ├── feature/user-auth
  │     ├── feature/payment-flow
  │     └── feature/dashboard-v2
  │
  ├── release/v1.2.0
  │
  └── hotfix/critical-bug

Branch Naming Convention

Tipo	Pattern	Exemplo
Feature	`feature/<descrição>`	`feature/user-authentication`
Bugfix	`bugfix/<issue-id>`	`bugfix/issue-123`
Hotfix	`hotfix/<descrição>`	`hotfix/security-patch`
Release	`release/<version>`	`release/v1.2.0`
Experiment	`experiment/<descrição>`	`experiment/new-cache`

Regras de Nomenclatura:

•Use kebab-case (palavras separadas por hífen)
•Seja descritivo mas conciso
•Inclua issue ID quando relevante
•Evite caracteres especiais

Commits

Conventional Commits

code

<type>(<scope>): <description>

[optional body]

[optional footer(s)]

Types:

Type	Quando Usar
`feat`	Nova funcionalidade
`fix`	Correção de bug
`docs`	Apenas documentação
`style`	Formatação (não afeta código)
`refactor`	Refatoração (sem feat/fix)
`perf`	Melhoria de performance
`test`	Adição/correção de testes
`chore`	Manutenção (build, deps, etc)
`ci`	Mudanças em CI/CD

Exemplos:

bash

# Feature
feat(auth): add OAuth2 login with Google

# Bug fix
fix(api): handle null response from payment gateway

Closes #123

# Breaking change
feat(api)!: change response format for /users endpoint

BREAKING CHANGE: response now returns array instead of object

Regras de Commit

code

┌─────────────────────────────────────────────────────────────┐
│  1. Commits atômicos - Uma mudança lógica por commit       │
│  2. Mensagem clara - Explica O QUE e POR QUÊ               │
│  3. Presente imperativo - "Add feature" não "Added"        │
│  4. Max 72 chars no título                                 │
│  5. Body para contexto adicional                           │
└─────────────────────────────────────────────────────────────┘

Commit Atômico - Exemplos:

bash

# ❌ RUIM - Múltiplas mudanças
git commit -m "Add login, fix header, update deps"

# ✅ BOM - Commits separados
git commit -m "feat(auth): add login form"
git commit -m "fix(ui): correct header alignment"
git commit -m "chore(deps): update React to v18"

Workflow Diário

1. Começar Feature

bash

# Atualizar develop
git checkout develop
git pull origin develop

# Criar branch
git checkout -b feature/minha-feature

# Trabalhar...
git add .
git commit -m "feat(scope): description"

2. Manter Branch Atualizada

bash

# Opção 1: Rebase (preferido para features)
git fetch origin
git rebase origin/develop

# Opção 2: Merge (se já compartilhou a branch)
git fetch origin
git merge origin/develop

3. Resolver Conflitos

bash

# Durante rebase
git rebase origin/develop
# Se conflito:
# 1. Resolver conflitos nos arquivos
# 2. git add <arquivos-resolvidos>
# 3. git rebase --continue

# Se quiser abortar
git rebase --abort

4. Preparar para PR

bash

# Squash commits se necessário
git rebase -i HEAD~<numero-de-commits>
# Marcar commits para squash (s) ou fixup (f)

# Push
git push origin feature/minha-feature

# Se já fez push antes e rebased
git push --force-with-lease origin feature/minha-feature

Pull Requests

Checklist Antes de Abrir PR

• Código compila sem erros
• Testes passam localmente
• Linter/formatter aplicado
• Branch atualizada com develop
• Commits organizados e descritivos
• Self-review feito

Template de PR

markdown

## Descrição
[O que este PR faz e por quê]

## Tipo de Mudança
- [ ] Feature nova
- [ ] Bug fix
- [ ] Refatoração
- [ ] Documentação
- [ ] Outro: ___

## Como Testar
1. [Passo 1]
2. [Passo 2]
3. [Resultado esperado]

## Checklist
- [ ] Código segue padrões do projeto
- [ ] Testes adicionados/atualizados
- [ ] Documentação atualizada
- [ ] Sem breaking changes (ou documentado)

## Screenshots (se aplicável)
[Imagens aqui]

## Issues Relacionadas
Closes #123

Tamanho do PR

code

┌─────────────────────────────────────────────────────────────┐
│  IDEAL: < 400 linhas de código                             │
│  MÁXIMO: 1000 linhas (divida se maior)                     │
│                                                             │
│  PRs menores = Reviews melhores = Menos bugs               │
└─────────────────────────────────────────────────────────────┘

Comandos Úteis

Desfazer Mudanças

bash

# Descartar mudanças não commitadas
git checkout -- <arquivo>
git restore <arquivo>  # Git 2.23+

# Desfazer último commit (mantém mudanças)
git reset --soft HEAD~1

# Desfazer último commit (descarta mudanças)
git reset --hard HEAD~1

# Reverter commit já pushed
git revert <commit-hash>

Stash (Guardar Temporariamente)

bash

# Guardar mudanças
git stash
git stash save "descrição"

# Listar stashes
git stash list

# Recuperar último stash
git stash pop

# Recuperar stash específico
git stash apply stash@{2}

Histórico e Busca

bash

# Log bonito
git log --oneline --graph --all

# Buscar em commits
git log --grep="palavra"

# Buscar quem mudou linha
git blame <arquivo>

# Buscar quando código foi adicionado
git log -S "código" --source --all

Cherry-pick

bash

# Aplicar commit específico na branch atual
git cherry-pick <commit-hash>

# Cherry-pick sem commitar
git cherry-pick -n <commit-hash>

Situações Comuns

"Commitei na Branch Errada"

bash

# Se ainda não fez push
git reset --soft HEAD~1
git stash
git checkout branch-correta
git stash pop
git commit -m "mensagem"

"Preciso Mudar Mensagem do Último Commit"

bash

# Apenas último commit, não pushed
git commit --amend -m "nova mensagem"

# Commits mais antigos
git rebase -i HEAD~3
# Marcar commit com 'reword'

"Quero Desfazer Merge"

bash

# Se não fez push
git reset --hard HEAD~1

# Se já fez push
git revert -m 1 <merge-commit-hash>

"Branch Divergiu Muito de Develop"

bash

# Opção 1: Rebase incremental
git fetch origin
git rebase origin/develop
# Resolver conflitos commit a commit

# Opção 2: Merge
git merge origin/develop
# Resolver todos conflitos de uma vez

Anti-Patterns

Anti-Pattern	Problema	Solução
`git add .` cego	Commita arquivos indesejados	`git add -p` ou review antes
Force push em shared branch	Perde trabalho dos outros	Use `--force-with-lease`
Commits gigantes	Difícil review e rollback	Commits atômicos
Branch de longa vida	Conflitos acumulam	Merge frequente ou feature flags
Mensagens vagas	"fix stuff", "wip"	Conventional commits

Esta skill ativa AUTOMATICAMENTE quando:

•Discussão sobre branches, commits, ou merges
•Usuário menciona "git", "PR", "pull request"
•Problemas com histórico ou conflitos