Create Pull Request

Create a GitHub pull request following project conventions with validation.

Task

IMPORTANT: Consult the PR CHECKLIST from git.md before proceeding.

Pre-PR Validation

Before creating the PR, verify:

1. Run tests (if applicable)

   npm test
   

2. Check current branch and commits

   git branch --show-current
   git log main..HEAD --oneline
   git diff main...HEAD --stat
   

3. Ensure changes are pushed

   git push -u origin $(git branch --show-current)
   

4. Check session file for summary content

   • Read .claude/sessions/<branch>.md
   • Verify session status is complete (should be marked before final commit)
   • Use Goal, Approach, Session Log for PR body

Determine PR Title Format

Format Requirements:

• Must match commit format exactly
• #N - lowercase description (for issues)
• chore - lowercase description (for chores)
• No emojis, no attribution

Generate PR Body

Use session file content to build the body:

## Summary
<2-3 bullets from Session Log or Approach>

## Test Plan
<How to verify the changes work>

## Acceptance Criteria
<From issue, if applicable>
- [ ] Criterion 1
- [ ] Criterion 2

IMPORTANT:

• No attribution (no "Generated with Claude", no co-authored-by)
• No emojis
• No AI mentions

Create the PR

gh pr create --title "#42 - add user authentication" --body "$(cat <<'EOF'
## Summary
- Implement login form with email/password fields
- Add JWT token handling with httpOnly cookies
- Create auth middleware for protected routes

## Test Plan
- Run `npm test` to verify unit tests pass
- Manually test login flow at /login

## Acceptance Criteria
- [x] Login form with email and password fields
- [x] Secure token storage
- [ ] Auto-logout on token expiry (follow-up)
EOF
)"

After Creation

1. Display the PR URL
2. Working directory should be clean (no uncommitted changes)
3. Suggest next steps:
   • Review the PR in browser
   • Request reviewers if needed

Note: Do NOT update the session file after PR creation. The PR number is discoverable via gh pr view—no need to store it in the session.

Example Interaction

User: /onus:pr

Claude: I'll help you create a PR. Let me check the branch and commits.

[Runs git branch, git log, reads session file]

Branch: issue/feature-42/auth
Commits: 3 commits ahead of main
Session: Goal is "Add user authentication"

Creating PR with title matching your commits...

gh pr create --title "#42 - add user authentication" --body "..."

Created: https://github.com/org/repo/pull/87

Next steps:
- Review at the link above
- Request reviewers if needed

Troubleshooting

"Pull request already exists"?

• Check existing PRs: gh pr list
• View existing PR: gh pr view

Wrong base branch?

• Specify base: gh pr create --base main

Need to update PR after creation?

• Edit title: gh pr edit --title "new title"
• Edit body: gh pr edit --body "new body"

Authentication failed?

• Ensure gh auth status shows logged in
• Check token has repo scope