pr

PR — Create Pull Request with AI Review

Create a GitHub Pull Request with full AI review. Human approves and merges — do NOT merge automatically; always stop after PR creation and AI review.

Step 0 — Smart default: ensure feature branch

PROJECT_ROOT=$(git rev-parse --show-toplevel)
cd "$PROJECT_ROOT"
DEFAULT_BRANCH=$(git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's@^refs/remotes/origin/@@')
DEFAULT_BRANCH="${DEFAULT_BRANCH:-main}"
CURRENT_BRANCH=$(git branch --show-current)

If on the default branch: Run the branch workflow first to create a feature branch. Then continue.

If on a feature branch: Continue with PR creation.

---

Phase 1 — Pre-flight

Run the gate workflow. All gates must pass before creating a PR (Gates 1–3 always; Gates 4–5 when applicable).

If any gate fails → STOP. Fix issues first. Do NOT create a PR with failing gates.

---

Phase 2 — Push branch

git push -u origin "$CURRENT_BRANCH"

---

Phase 3 — Generate PR content

Title

• Derive from branch name and commit messages
• Under 70 characters
• Use conventional format: feat: add user authentication

Body

Generate from the diff against the default branch:

git log "$DEFAULT_BRANCH"..HEAD --oneline
git diff "$DEFAULT_BRANCH"...HEAD --stat

Structure the body as:

## Summary
- [2-3 bullet points describing what changed and why]

## Changes
- [list of key files/areas modified]

## Test plan
- [ ] [How this was tested]
- [ ] [What to verify during review]

## Related issues
[Auto-detected from commit messages: "fixes #42", "closes #13", etc.]

---

Phase 4 — Create PR

gh pr create \
  --title "<generated title>" \
  --body "<generated body>" \
  --base "$DEFAULT_BRANCH" \
  --head "$CURRENT_BRANCH"

Capture the PR number and URL from the output.

---

Phase 5 — AI Review

Review the full diff and post findings as a PR comment.

What to review

# Get the full diff for review
git diff "$DEFAULT_BRANCH"...HEAD