Creating Contextual Branch and PR

Bash
# 1. Inspect changes
git status
git diff

# 2. Create branch (pattern-based naming)
git checkout -b feature/short-description
# or: fix/, chore/, hotfix/, release/

# 3. Stage and commit by context
git add <related-files>
git commit -m "feat(scope): add short description of change"

# 4. Push and open PR
git push -u origin feature/short-description
gh pr create --fill   # or `glab mr create --fill` for GitLab

Progress:

• Step 1: Rodar git status e git diff para entender o que mudou
• Step 2: Agrupar arquivos alterados por contexto/funcionalidade
• Step 3: Definir o tipo de branch e nome (padrão de feature branch)
• Step 4: Criar a branch a partir da branch base atualizada
• Step 5: Gerar commits separados por contexto, com mensagens Conventional Commits
• Step 6: Push da branch
• Step 7: Abrir PR/MR com título e descrição baseados nos commits

Detalhes

1. Contextualizar mudanças

• git status para ver arquivos modificados/novos/deletados.
• git diff (ou git diff --staged) para entender a natureza da mudança.
• Agrupar arquivos que pertencem à mesma alteração lógica (ex: componente + teste + estilo).

2. Nomear a branch Seguir padrão tipo/descrição-curta-com-hifens:

• feature/<descricao> — nova funcionalidade
• fix/<descricao> — correção de bug
• chore/<descricao> — manutenção, configs, deps
• hotfix/<descricao> — correção urgente em produção
• release/<versao> — preparação de release

Nome curto, minúsculo, sem espaços, refletindo o objetivo (ex: feature/add-user-login).

3. Criar a branch

Bash
git checkout main
git pull origin main
git checkout -b feature/add-user-login

4. Commits por contexto (Conventional Commits) Formato: <tipo>(<escopo opcional>): <descrição curta no imperativo>

Tipos comuns: feat, fix, docs, style, refactor, test, chore, perf, build, ci.

• Um commit por mudança lógica coesa (não misturar contextos diferentes no mesmo commit).
• Mensagem curta (até ~72 caracteres na primeira linha), descrição no corpo se necessário.

Bash
git add src/auth/
git commit -m "feat(auth): add login form validation"

git add tests/auth/
git commit -m "test(auth): add unit tests for login validation"

5. Push e abertura do PR/MR

Bash
git push -u origin feature/add-user-login
gh pr create --title "feat(auth): add login form validation" --body "Resumo das mudanças, contexto e como testar."

Título do PR/MR deve seguir o mesmo padrão do commit principal; a descrição deve resumir os commits e o contexto da mudança.