Melhoria de Pull Request

Quando Usar

• Você precisa transformar um diff do Git em uma descrição de pull request amigável para revisores.
• Você quer um resumo de PR com categorias de alteração, riscos, notas de teste e uma lista de verificação.
• O diff é grande o suficiente para que os revisores precisem de uma estrutura explícita em vez de um resumo curto e ad hoc.

Fluxo de Trabalho

1. Execute git diff <base>...HEAD --stat para identificar arquivos alterados e escopo.
2. Categorize as alterações: fonte, teste, configuração, docs, build, estilos.
3. Gere a descrição do PR usando o template abaixo.
4. Adicione uma lista de verificação de revisão com base nas categorias de arquivos alteradas.
5. Sinalize alterações que quebram compatibilidade, arquivos sensíveis à segurança ou diffs grandes (>500 linhas).

Template de Descrição de PR

## Summary
<!-- one-paragraph executive summary: what changed and why -->

## Changes
| Category | Files | Key change |
|----------|-------|------------|
| source   | `src/auth.ts` | added OAuth2 PKCE flow |
| test     | `tests/auth.test.ts` | covers token refresh edge case |
| config   | `.env.example` | new `OAUTH_CLIENT_ID` var |

## Why
<!-- link to issue/ticket + one sentence on motivation -->

## Testing
- [ ] unit tests pass (`npm test`)
- [ ] manual smoke test on staging
- [ ] no coverage regression

## Risks & Rollback
- **Breaking?** yes / no
- **Rollback**: revert this commit; no migration needed
- **Risk level**: low / medium / high — because ___

Regras da Lista de Verificação de Revisão

Adicione seções à lista de verificação apenas quando a categoria de arquivo correspondente aparecer no diff:

Divisão de PRs Grandes

Quando o diff exceder 20 arquivos ou 1000 linhas, sugira dividir por área de funcionalidade:

git checkout -b feature/part-1
git cherry-pick <commits-for-part-1>

Recursos

• resources/implementation-playbook.md — Helpers em Python para análise automatizada de PR, relatórios de cobertura e pontuação de risco.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como substituta para validação específica do ambiente, testes ou revisão de especialistas.
• Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem faltando.