Creating and Updating PRs

Creating a PR

1. Target: Open the PR into upstream/dev using the GitHub CLI (gh).
2. Describe from commits: On the branch, inspect commits (e.g. git log upstream/dev..HEAD --oneline or gh pr view for an existing branch) to build the description.
3. Changelog-style body: Write the PR description as a changelog, grouping changes into:
   • New Features
   • Bug Fixes
   • Refactors
   • Documentation
   • Tests Include only sections that apply; omit empty ones.

Commands:

bash
1# Inspect commits on current branch vs upstream/dev
2git log upstream/dev..HEAD --oneline
3
4# Create PR (replace <owner>/<repo> with actual upstream, e.g. from git remote)
5gh pr create --base dev --repo <owner>/<repo> --title "feat(scope): short description" --body "..."

Body template:

markdown
1## New Features
2- Bullet per feature
3
4## Bug Fixes
5- Bullet per fix
6
7## Refactors
8- Bullet per refactor
9
10## Documentation
11- Bullet per doc change
12
13## Tests
14- Bullet per test change

Updating a PR

1. Locate the PR: Use gh pr list or gh pr view (when on the branch) to find the PR.
2. Update content: Refresh title, body, or both from:
   • Current commits on the branch (git log upstream/dev..HEAD --oneline), or
   • Explicit user instructions.
3. Changelog-style: Keep the description in changelog form (same sections as above).
4. Status (when requested):
   • Mark ready for review: gh pr ready <number>
   • Mark as draft: gh pr edit <number> --draft
   • Close: gh pr close <number>
   • Reopen: gh pr reopen <number>

Commands:

bash
1# Edit title and/or body
2gh pr edit <number> --title "feat(scope): new title" --body "$(cat pr-body.md)"
3
4# Status
5gh pr ready <number>
6gh pr edit <number> --draft
7gh pr close <number>
8gh pr reopen <number>

Examples

Create PR from branch:

bash
1gh pr create --base dev --repo owner/repo --title "feat(chat): render opportunity cards in message stream" --body "## New Features
2- Render opportunity cards inline in chat message stream
3
4## Bug Fixes
5- Fix scroll position when new messages load"

Update existing PR:

bash
1gh pr edit 42 --title "feat(chat): opportunity cards in stream" --body "$(cat pr-body.md)"
2gh pr ready 42