update-pr-desc

Update Pull Request Description

Update an existing PR description when additional fixes or changes have been made after the original PR was opened.

Use Cases

• Follow-up fixes after code review feedback
• Additional changes discovered during testing
• Expanding scope based on new requirements
• Bug fixes found during PR review

Instructions

1. Find the Current PR

# Get the PR number for current branch
gh pr view --json number,title,body,url,createdAt

# Get the original PR description
gh pr view --json body --jq '.body'

# Get the base commit (when PR was created)
gh pr view --json baseRefName,headRefName,commits

2. Analyze New Changes

# Get the original PR merge base
MERGE_BASE=$(git merge-base main HEAD)

# Find commits added since PR was opened
# (Compare against the first commit in the PR)
FIRST_COMMIT=$(gh pr view --json commits --jq '.commits[0].oid')

# Show new commits (those after the first PR commit)
git log --oneline ${FIRST_COMMIT}..HEAD

# Show what files changed in new commits
git diff --stat ${FIRST_COMMIT}..HEAD

# Get detailed view of new changes
git diff ${FIRST_COMMIT}..HEAD

3. Prepare Updated Description

Preserve the original PR content and append a "Follow-up Changes" section:

<original PR body preserved as-is>

---

## Follow-up Changes

<Date or context for when these changes were added>

### Additional Changes

- <Change 1: what and why>
- <Change 2: what and why>

### New Commits

- `<sha>` <commit message>
- `<sha>` <commit message>

### Reason for Changes

<Brief explanation of why follow-up changes were needed>
- Code review feedback
- Bug discovered during testing
- Expanded scope
- etc.

4. Update the PR

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

5. Add a Comment (Optional)

For visibility, add a PR comment summarizing the update:

gh pr comment --body "$(cat <<'EOF'
## PR Updated

Added follow-up changes:
- <brief summary of changes>

See updated PR description for details.
EOF
)"