harnessprotocol/open-pr

Open PR

A structured PR preparation workflow: tests → create PR → code review → CI → hand off to merge.

Announce at start: "I'm using the open-pr skill to get this PR ready."

---

Step 1: Pre-flight — Run Local Tests

Run the test suite before touching anything else. Detect the right command from project files:

| Indicator | Command | |-----------|---------| | CLAUDE.md test command | Use that (takes precedence over all below) | | go.mod | go test ./... | | package.json | npm test or yarn test | | pyproject.toml / setup.py | pytest | | Cargo.toml | cargo test |

If tests fail: Stop. Show the failures clearly. Don't proceed — fix them or ask the user how to handle. Do not skip or bypass test hooks.

If tests pass: Continue.

---

Step 2: Check for Existing PR

gh pr view --json number,url,state 2>/dev/null

• PR already open: Skip to Step 4 — Code Review.
• No PR: Continue to Step 3.

---

Step 3: Create the PR

Push the branch

git push -u origin $(git branch --show-current)

Title

Use the most meaningful commit message as a starting point, cleaned up to be concise. Follow conventional commit format (feat:, fix:, refactor:, etc.) if the repo uses it — check recent commits with git log --oneline -10.

Auto-detect labels

Infer labels from the branch name and commits — apply with --label if the label exists in the repo:

| Pattern | Label | |---------|-------| | fix/, bug/, "fix" in commits | bug | | feat/, feature/ | enhancement | | refactor/, chore/ | refactor | | docs/ | documentation |

Skip labels that don't exist in the repo rather than erroring.

PR description template

Fill in every section based on the actual changes — no unfilled placeholders:

## Summary
<!-- What this PR does and why — 2-4 sentences. Lead with intent, not implementation. -->

## Changes
<!-- Key changes. Be specific — not "updated code" but what and why. -->
-

## Test Plan
<!-- How this was verified -->
- [ ] Local tests pass
- [ ] CI checks pass
- [ ] <any manual or integration steps>

## Notes
<!-- Edge cases, follow-ups, known limitations, or anything a reviewer should know -->

Create

gh pr create \
  --title "<title>" \
  --body "$(cat <<'EOF'
<filled-template>
EOF
)"

Leave --reviewer and --assignee unset.

---

Step 4: Code Review

Invoke the review skill (use the Skill tool) to review all changes in this PR.

The review should cover:

• Baseline: correctness, security, error handling, performance, naming clarity
• Test coverage: flag any new functionality that lacks tests
• Codebase-specific: scan CLAUDE.md for any ## Code Review, ## Standards, or ## Gotchas sections and incorporate those requirements

After the review, present a clear report:

Code Review Report
──────────────────
[MUST FIX] <issue> — <file>:<line>
[SUGGESTION] <issue>
No blocking issues found.

If MUST FIX items: Address them, commit, push. Once resolved, continue to Step 5.

If only suggestions: Note them for the user to follow up post-merge at their discretion.

---

Step 5: CI Status

gh pr checks

All passing: Continue.

Failing:

1. Read the failure output — identify root cause
2. Quick fix (lint, formatting, import, typo): Fix it, commit, push, wait for CI to rerun, then continue
3. Complex failure (logic error, architecture issue, flaky infra): Stop and report clearly:

   "CI is failing due to [X]. This needs a dedicated fix before merging — let's plan it out."

Never proceed to merge with failing CI.

---

Step 6: Report and Hand Off

Once tests, review, and CI are all green, report the PR status and suggest the next step:

PR #<N> is ready to merge.
──────────────────────────
Title:  <title>
Branch: <branch> → <base>
URL:    <url>

✓ Local tests pass
✓ Code review clean (or: N suggestions noted for follow-up)
✓ CI passing

Run /merge-pr to squash merge and clean up.

Do not merge, rebase, or push anything further. Hand off cleanly.

---

Quick Reference

| Step | Action | Block on failure? | |------|--------|-------------------| | 1. Local tests | Run test suite | Yes — fix first | | 2. PR check | Exists? | Skip to review | | 3. Create PR | Push + gh pr create | — | | 4. Code review | review skill | Yes for MUST FIX | | 5. CI | gh pr checks | Yes — fix or stop | | 6. Report | PR summary + /merge-pr suggestion | — |

Rules

Never:

• Proceed with failing tests or CI
• Merge, rebase, or force-push anything
• Use --no-verify to bypass hooks
• Leave PR template sections unfilled
• Set reviewer or assignee

Always:

• Address MUST FIX review items before handing off
• Suggest /merge-pr at the end