merge-pr

Merge PR

Verifies that a pull request has the required approvals and passing CI checks, then merges it and cleans up the branch.

Prerequisites

• Apply the shared SDLC conventions in skills/sdlc/references/shared.md.
• If no argument is provided, target the pull request from $PR_NUMBER (and $REPO).
• gh CLI authenticated with write access to the target repository
• PR number ($1) identifying an open pull request
• All review feedback addressed (run /handle-pr-reviewer-feedback first if comments are unresolved)

Workflow

Fetch PR status ($1)
        |
        v
  All approvals obtained?
     /         \
   Yes           No
    |             |
    v             v
CI checks      Report missing
passing?       approvals, stop
   /    \
 Yes     No
  |       |
  v       v
Merge   /handle-pr-ci
PR      (fix, then re-check)
  |
  v
Delete remote branch
  |
  v
Delete prs/<n>/review tag
  |
  v
Confirm issue closed

Steps

1. Fetch the current PR status:

   gh pr view $1 --json state,reviews,statusCheckRollup,mergeStateStatus,headRefName,closingIssuesReferences
   

2. Check approvals: confirm at least one reviewer has approved and no reviewers have requested changes. If approvals are missing or changes are requested, report the status and stop.

3. Check CI: confirm all required status checks are passing. If any are failing or pending, invoke /handle-pr-ci $1 to diagnose and fix before continuing.

4. Present the merge summary to the user (PR title, approvals, checks) and ask for confirmation.

5. On confirmation, merge the PR:

   gh pr merge $1 --squash --delete-branch
   

   Use --squash by default for a clean history. If the project uses merge commits or rebase, adjust accordingly.

6. Confirm the remote branch was deleted. If not, delete it:

   gh api repos/{owner}/{repo}/git/refs/heads/{branch} -X DELETE
   

7. Delete the review checkpoint tag left by validate-pr / verify-pr / review-pr (see sdlc/references/shared.md, Review checkpoint tags):

   git tag -d "prs/$1/review" 2>/dev/null || true