open-pr

name	open-pr
description	Phase 2 of the PLEXI ship pipeline. Takes a pushed feature branch, creates a PR targeting alpha, updates pipeline labels, and invokes /validate-pr inline. Input: branch name or auto-detect from CWD. Output: PR URL.
risk	medium
source	local
date_added	2026-05-20

Open PR

Phase 2 of the ship pipeline. Input: pushed feature branch. Output: PR open, pipeline advanced to validate.

Entry points:

• /open-pr — auto-detect branch from CWD (must be inside a feature worktree)
• /open-pr <branch-name> — explicit branch (e.g. feature/1234-something)
• /open-pr <pr-number> — existing PR, skip creation and advance labels only

On completion output:

[PR OPENED] PR #<n> — <title>
PR: <url>
Pipeline: pipeline:validate + ready set — invoking /validate-pr inline

Labels are live state — never the Ship Log. Pane: plexi${PLEXI_CHANNEL:+-$PLEXI_CHANNEL} pane name "#<n> · <state>" — no digit in status. State: pr-open. Source _lib/pipeline-slots.sh; call pipeline_slots_set open-pr <issue> <pr> <status> "" "" at phase boundaries.

---

Step 1 — Detect Branch and Issue

Auto-detect from CWD:

git branch --show-current

Must be a feature/ or fix/ branch. Fail loudly if on alpha, beta, or main.

Explicit branch: verify it exists on origin:

git ls-remote origin "refs/heads/<branch>"

Classify the branch first — stint-first or issue-first. .stint/ is authoritative and GitHub issues are optional, so a branch may have no issue at all. Match in this order:

• feature/stint-<id>[-<id>...]-<slug> → stint-first, no issue. Do NOT try to read an issue number out of it — 0469 is a stint id, and treating it as issue #469 attaches the PR to something unrelated.
• feature/<number>-... → single issue
• feature/bundle-<n1>-<n2>-... → multiple issues

Stint-first — resolve titles from stint, not GitHub:

stint show <id>            # title + body for the PR description

For the rest of this skill in stint-first mode: ISSUE_NUMBER is empty, there is no Closes #<n> line (name the stint ids in the body instead), the Ship Log lives in the PR description rather than an issue body, and pipeline labels are skipped entirely — they live on issues, and there is no issue to label. Skip those gh issue edit calls rather than erroring on them.

Issue-first — fetch issue title(s) for PR body:

gh issue view <number> --json title --jq '.title'

---

Step 2 — Create PR

Idempotency guard — check for existing PR first:

EXISTING_PR=$(gh pr list --head <branch> --state open --json number,url --jq '.[0] // empty')

If non-empty: skip gh pr create, use the existing PR number, advance pipeline labels, invoke /validate-pr.

Create PR targeting alpha:

Single issue:

PR_URL=$(gh pr create \
  --base alpha \
  --head <branch> \
  --title "<issue-title> (#<number>)" \
  --body "$(cat <<'EOF'
Closes #<number>

## Summary

<2-3 bullet points summarizing what changed and why>

## Done When

<paste Done When checklist from issue body>
EOF
)")
PR_NUMBER=$(echo "$PR_URL" | grep -oE '[0-9]+$')

Bundle (feature/bundle-<n1>-<n2>-...):

PR_URL=$(gh pr create \
  --base alpha \
  --head <branch> \
  --title "<short summary> (#<n1>, #<n2>)" \
  --body "$(cat <<'EOF'
Closes #<n1>, Closes #<n2>

## Summary

**#<n1> — <issue-n1-title>**
- <bullet summarizing n1 change>

**#<n2> — <issue-n2-title>**
- <bullet summarizing n2 change>

## Done When — #<n1>
<checklist>

## Done When — #<n2>
<checklist>
EOF
)")
PR_NUMBER=$(echo "$PR_URL" | grep -oE '[0-9]+$')

Stint-first (feature/stint-<id>...) — no Closes #, name the stints instead:

PR_URL=$(gh pr create \
  --base alpha \
  --head <branch> \
  --title "<short summary> (stint <id>[, <id>])" \
  --body "$(cat <<'EOF'
## Summary

Implements stint <id>[, <id>]. No linked GitHub issue — stint is authoritative.

<2-3 bullet points summarizing what changed and why>

## Done When

<paste Scope / acceptance from `stint show <id>`>
EOF
)")
PR_NUMBER=$(echo "$PR_URL" | grep -oE '[0-9]+$')

Keep every stint id in the body — just merge-pr resolves the tasks to close from the branch name plus the PR body only; the title is never read.

Update pane status:

plexi${PLEXI_CHANNEL:+-$PLEXI_CHANNEL} pane name "#<n> · pr-open"
pipeline_slots_set open-pr <n> "$PR_NUMBER" pr-open "" ""

---

Step 3 — Ship Log + Pipeline Labels

Stint-first: skip this entire step. There is no issue body to append to and no issue to label; the PR description is the Ship Log. Go straight to Step 4.

Issue-first — append to ## Ship Log in each issue's body:

**PR:** #<pr-number> — <pr-url>

# Repeat for each issue number N:
CURRENT_BODY=$(gh issue view <N> --json body --jq '.body')
gh issue edit <N> --body "$(printf '%s\n**PR:** #%s — %s\n' "$CURRENT_BODY" "$PR_NUMBER" "$PR_URL")"

Set pipeline state on every issue:

# Repeat for each issue number N:
gh issue edit <N> \
  --add-label "pipeline:validate" \
  --add-label "ready" \
  --remove-label "pipeline:open-pr" \
  --remove-label "in progress"

Invoke /validate-pr <pr-number> inline in the same pane — unless the caller asked to stop at PR-open (babysitter workers always do). In that mode, report the PR number and check status and end the turn; a separate tester owns validation.

---

Rules

• PR always targets alpha — never beta or main
• Never push to alpha, beta, or main directly
• Idempotency: re-running on an already-open PR advances labels, never errors
• open-pr runs no review. AI diff review is owned solely by /implement-stint Phase 4 (pre-push) — see "Who reviews what" there. /validate-pr does not review either.