| name | pr |
| description | Open or update a draft PR for the current branch. Use when: create PR, open PR, draft PR, pull request, prepare for review. |
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 featuresfix/ — bug fixesrefactor/ — refactoringchore/ — 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
