pr-merge

Context

You are running in a GitHub Actions VM. The repo is checked out at the PR branch. You have access to Read, Write, and Bash tools. Do not attempt to use git or gh. The workflow handles the actual merge after you finish.

PR metadata, review comments, and commit history are provided in your prompt.

If this repo has a CLAUDE.md or any other AI directions, read them for context.

Do NOT create tasks or use TodoWrite. Keep it simple.

Process

1. Gather context

Review the commit history and PR comments (provided in your prompt) to understand the full journey — initial implementation and any rejection cycles. The linked issue (the original plan) is also included in your context.

2. CRITICAL: Test Validation

Before writing ANY files, check if the repo has tests. Look for test directories, test scripts in package.json, or test configuration files. If tests are present, run them.

IF no tests are present:

• Skip this step and proceed to write the commit message

IF tests are present:

Run the full test suite by default. Only skip specific test suites if the project's CLAUDE.md explicitly says to. Do not assume certain tests won't run or can be excluded. The golden rule: if tests are present, every test of every type must pass.

Run them and check the exit code:

Exit code 0 (all tests passed):

• Write comment.txt explaining that all tests passed and the PR will be merged
• Proceed to write commit_msg.txt
• Proceed with merge process

Exit code NOT 0 (any test failed):

• Write comment.txt explaining which tests failed and why, and explaining that you cannot merge if tests fail
• DO NOT write commit_msg.txt
• DO NOT proceed with merge
• Your task is complete - exit

IMPORTANT: You MUST ALWAYS write comment.txt in both cases. Writing commit_msg.txt when tests have failed is a critical error. The commit_msg.txt file MUST ONLY exist if all tests passed. If you are unsure whether tests passed, run them again. Never assume tests passed without checking the exit code.

If the repo has no tests, that's fine — skip straight to the merge. If it does, tests are not optional. Tests are not suggestions. All tests must pass before merge.

3. Write the commit message

Write a clean commit message describing what was built. Follow the conventions in the commit skill at ../commit/SKILL.md.

The message should read as if the work was done right the first time. No mention of rejections, fix cycles, or iterations. Just the final result.

The first line of the commit body (after the subject and blank line) must be issue: #<issue-number>.

Output

Write these files:

• /tmp/comment.txt — ALWAYS write this. Comment explaining test results and what will happen (merge or not).
• /tmp/commit_msg.txt — ONLY write this if tests passed. The clean squash-merge commit message.

The workflow will post the comment, then merge the PR if commit_msg.txt exists.