git-pr

name	git-pr
description	Generate a pull request description from branch changes. Use when creating a PR or preparing PR documentation.
disable-model-invocation	true
allowed-tools	Bash(git:*), Bash(gh:*)

Generate PR Description

Create a comprehensive pull request description based on the branch diff.

Process

1. Gather Context

# Get current branch name
git branch --show-current

# Find base branch (usually main or master)
git remote show origin | grep 'HEAD branch'

# Get all commits on this branch
git log main..HEAD --oneline

# Get the full diff
git diff main...HEAD --stat
git diff main...HEAD

2. Analyze Changes

Categorize the changes:

• Features: New functionality
• Fixes: Bug fixes
• Refactors: Code improvements without behavior change
• Docs: Documentation updates
• Tests: Test additions/changes
• Chores: Dependencies, configs, tooling

3. Generate PR Description

Use this format:

## Summary

[2-3 sentences describing what this PR does and why]

## Changes

- [Bullet point for each logical change]
- [Group related file changes together]
- [Focus on what changed, not how]

## Type of Change

- [ ] Bug fix (non-breaking change that fixes an issue)
- [ ] New feature (non-breaking change that adds functionality)
- [ ] Breaking change (fix or feature that causes existing functionality to change)
- [ ] Refactor (no functional changes)
- [ ] Documentation update

## Testing

[How was this tested? What should reviewers verify?]

- [ ] Unit tests pass
- [ ] Integration tests pass
- [ ] Manual testing completed

## Screenshots (if applicable)

[Add screenshots for UI changes]

## Checklist

- [ ] My code follows the project's style guidelines
- [ ] I have performed a self-review
- [ ] I have added tests that prove my fix/feature works
- [ ] New and existing unit tests pass locally
- [ ] Any dependent changes have been merged

---

Generated with Claude Code

4. Determine Title

PR title format: type(scope): description

Examples:

• feat(auth): add OAuth2 login support
• fix(api): handle null response from payment service
• refactor(db): extract query builder into separate module

5. Output

Provide:

1. Suggested PR title
2. Full PR description in markdown
3. Suggested reviewers (if CODEOWNERS exists)
4. Labels to add (if .github/labels.yml exists)

6. Create PR (Optional)

If user confirms, create the PR:

gh pr create --title "..." --body "..."

Guidelines

• Focus on why over what (the diff shows what)
• Link to related issues: Fixes #123 or Relates to #456
• Call out breaking changes prominently
• Mention any manual steps required post-merge
• Keep bullet points scannable (one line each)