Draft PR Creator

Creates or updates a draft pull request for the current branch.

Usage

• /pr - Create draft PR for current branch (or update if one exists)
• /pr <url> - Update existing PR description

Workflow

1. Ensure feature branch and commit

NEVER commit to main unless the user explicitly requests it.

git branch --show-current
git status

If on main, create and switch to a feature branch before doing anything else.

Branch naming follows the PR type prefix:

• feat/ — new features
• fix/ — bug fixes
• refactor/ — refactoring
• chore/ — maintenance

2. Gather context

git log main..HEAD --oneline
git diff main...HEAD --stat

3. Check if PR already exists

gh pr view --json number,title,body 2>/dev/null

4. Write PR description

Use the template below. Keep it concise and natural.

5a. If NO existing PR - Create draft PR

gh pr create --draft --title "<title>" --body "$(cat <<'EOF'
<body>
EOF
)"

5b. If PR already exists - Update description

gh pr edit --title "<title>" --body "$(cat <<'EOF'
<updated body>
EOF
)"

Report the PR URL to the user when done.

PR Title Format

<type>: <short description>

Types: feat:, fix:, refactor:, test:, chore:, docs:

Rules:

• Lowercase after prefix
• Present tense imperative ("add" not "added")
• Under 70 characters

PR Body Template

Closes #<issue_number>

## Summary

1-2 paragraphs explaining what this does and why.

## Changes

- Highlight 1
- Highlight 2
- Highlight 3

## Testing

- [ ] `mix test` passes
- [ ] `mix format --check-formatted` passes
- [ ] `mix compile --warnings-as-errors` passes

Omit the Closes #... line if there is no source issue.

Style

• Fluid prose in Summary — natural writing, not robotic
• 2-3 bullet points in Changes — highlights only, not a file list
• No file lists — GitHub shows that in "Files changed"

Pipeline

/dev <issue> -> /review -> /commit -> /pr -> merge