MODULO 3.7

👾 Criar Pull Request

Workflow completo para criar Pull Requests profissionais usando o comando /pr do Claude Code.

6
Topicos
15
Minutos
Inter.
Nivel
Pratico
Tipo
1

📦 Preparar os Commits

Antes do PR, garanta que seus commits estao limpos e organizados. Um PR com commits bagunçados dificulta o review.

💡 Conceito Principal

Prepare a branch antes de criar o PR:

  • •"Verifique se tem mudancas nao commitadas e faca commit de tudo"
  • •"Rode os testes uma ultima vez antes do PR"
  • •Garanta que a branch esta atualizada: "Faca rebase com main se necessario"

⚡ Dica Pratica

Checklist pre-PR: "Antes do PR: 1) rode os testes 2) rode o linter 3) verifique se nao tem console.log perdido 4) faca /review"

2

⚡ O Comando /pr

O comando /pr cria um Pull Request completo no GitHub com titulo, descricao e labels gerados automaticamente.

💡 Conceito Principal

Como o /pr funciona:

  • •Digite /pr no Claude Code
  • •O Claude analisa todos os commits da branch, entende as mudancas e cria o PR
  • •Ele usa gh pr create com titulo e descricao gerados

⚡ Dica Pratica

Voce precisa ter o gh (GitHub CLI) instalado e autenticado. Rode gh auth status para verificar.

3

📝 O que o Claude Gera

O Claude gera uma descricao completa do PR incluindo resumo, mudancas, testing e notas para reviewers.

💡 Conceito Principal

Estrutura tipica do PR gerado:

  • •Titulo: Conciso e descritivo seguindo Conventional Commits
  • •Summary: O que foi feito e por que
  • •Changes: Lista detalhada de mudancas por arquivo/modulo
  • •Test plan: Como testar as mudancas

⚡ Dica Pratica

Customize o template no CLAUDE.md: "Ao criar PRs, sempre inclua: screenshots se tiver UI, link do ticket Jira, e breaking changes"

4

👁️ Revisar a Descricao

Sempre revise a descricao antes de confirmar. O Claude pode errar detalhes ou omitir contexto importante que so voce sabe.

💡 Conceito Principal

O que verificar na descricao gerada:

  • •O titulo reflete a mudanca principal? E claro para quem nao tem contexto?
  • •O "por que" esta explicado? (motivacao, ticket, bug report)
  • •Tem informacoes sensiveis que nao deveriam estar no PR?

⚡ Dica Pratica

Peca ajustes: "Adicione o link do ticket JIRA-1234 e mencione que isso e um hotfix para producao"

5

🔧 Ajustar e Customizar

Peca ao Claude para ajustar o PR conforme as convencoes do seu time - labels, reviewers, milestones, etc.

💡 Conceito Principal

Customizacoes comuns para PRs:

  • •"Adicione os labels 'bug' e 'high-priority' ao PR"
  • •"Assigne @joao e @maria como reviewers"
  • •"Crie como draft PR para review interno primeiro"

⚡ Dica Pratica

Automatize no CLAUDE.md: "Ao criar PRs para bugfix, sempre adicione label 'bug' e assigne ao tech lead como reviewer"

6

📚 Boas Praticas de PR

Siga estas boas praticas para criar PRs que sao faceis de revisar e aprovar rapidamente.

💡 Conceito Principal

PRs excelentes seguem estas regras:

  • •PRs pequenos (menos de 400 linhas) sao revisados 3x mais rapido
  • •Cada PR deve fazer uma coisa - nao misture feature + refactor + bugfix
  • •Inclua screenshots para mudancas de UI
  • •Use o workflow: /review → fix → /commit → /pr

⚡ Dica Pratica

Para features grandes, use stacked PRs: "Crie 3 PRs separados: 1) modelo + migration, 2) API endpoints, 3) frontend"

📋 Resumo do Modulo

✓
Commits - Prepare commits limpos antes do PR
✓
/pr - Gera PR completo via gh CLI
✓
Conteudo - Titulo, summary, changes, test plan
✓
Revisao - Sempre revise a descricao gerada
✓
Ajustes - Labels, reviewers, draft mode
✓
Boas Praticas - PRs pequenos, focados e bem documentados

Proximo Modulo:

3.8 - Debug com Logs e Erros

← Voltar Proximo Modulo →