# Pr Merge Cleanup

> Apply cleanup after confirming a PR merge. Close the GitHub Issue, delete the remote publish/task{N} branch, clean up the local local/task{N} branch and separate worktree, and return to {BASE_BRANCH}. Invoke only after the PR is actually merged.

- Skill: `postmelee/pr-merge-cleanup-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add postmelee/pr-merge-cleanup-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/postmelee/pr-merge-cleanup-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: postmelee (https://skillmd.com/u/postmelee)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/postmelee/pr-merge-cleanup-2

---


# PR Post-merge Cleanup

## Trigger

- The task requester explicitly says "cleanup after merge" or "clean up the task."
- This SKILL is invoked directly.

## Preconditions

- The target PR is actually merged on GitHub: `gh pr view {number} --json state,mergeCommit`.
- The task requester approved Issue close, or the PR body included `closes #N` and the Issue was automatically closed.

## Procedure

1. Check PR and Issue state.
   ```bash
   gh pr view {number} --json state,mergedAt,mergeCommit,headRefName
   gh issue view {N} --json state
   ```
   - If PR `state != MERGED`, stop immediately and report to the task requester.
2. Close the Issue only if it was not already closed.
   ```bash
   gh issue close {N}
   ```
3. Update `{BASE_BRANCH}`.
   ```bash
   git fetch origin --prune
   git checkout {BASE_BRANCH}
   git pull --ff-only
   ```
4. Delete the remote publish branch. Skip if the branch was already deleted by PR merge with `--delete-branch`.
   ```bash
   git push origin --delete publish/task{N} 2>&1 || echo "already deleted"
   ```
5. Remove the separate worktree if one was used.
   ```bash
   git worktree remove ../{repo}-task{N}
   git worktree prune
   ```
6. Delete the local work branch only when it is no longer needed.
   ```bash
   git branch -d local/task{N}
   # Forced deletion requires explicit task requester approval: git branch -D local/task{N}
   ```
7. Final daily task board check: confirm the #{N} row in `mydocs/orders/{yyyymmdd}.md` is `Done` with a completion time.
8. Report the cleaned items briefly to the task requester.

## Verification

- `gh pr view {number}` shows `state == MERGED`.
- `git branch -vv | grep local/task{N}` has no output if the branch was deleted.
- `git ls-remote origin publish/task{N}` has empty output.
- `git worktree list` does not include the cleaned worktree.
- `git branch --show-current` is `{BASE_BRANCH}`.

## Never Do

- Close an Issue when the PR is not merged.
- Delete another task branch or the main worktree.
- Run `git branch -D` without explicit approval; unmerged commits may be lost.
- Delete another worker's stash.

## Invocation

- Codex: `$pr-merge-cleanup` or the `/skills` menu
- Claude Code: `/pr-merge-cleanup`