pr-creator

Files (1)

• SKILL.md

SKILL.md (first lines)

# PR Creator

Creates a GitHub PR from committed changes with proper description, labels, and Notion integration.

## Configuration

Uses the **production API** by default. No configuration needed for read operations.

**Defaults (no setup required):**

- API URL: `https://api-gateway-856475788601.us-central1.run.app`
- Read-only endpoints at `/public/*` require no authentication

**For write operations** (PR registration, state transitions), set:

```bash
export PIPELINE_API_KEY="..."  # Get from GCP Secret Manager or ask admin
```

**Optional (for local working artifacts like plan.md):**

```bash
PIPELINE_DIR="${PIPELINE_DIR:-$HOME/repos/ticket-to-pr-pipeline}"
```

## Prerequisites

- Branch is not `main`
- All changes committed
- Branch pushed to remote

## Workflow

### 0. Verify Pipeline Ticket Exists

Before proceeding, confirm a ticket exists in the pipeline API. If not, run `ticket-intake` first.

```typescript
const ticket = await client.getTicket(ticketId)
if (!ticket) {
  throw new Error('❌ No pipeline ticket found. Run ticket-intake first to register this ticket in the pipeline API.')
}
```

If no `ticketId` is available, search by Notion page ID or list recent tickets:

```typescript
const ticket = await client.findByNotionId(notionPageId)
if (!ticket) {
  console.error('❌ No pipeline ticket found for this Notion page. Run ticket-intake first.')
  process.exit(1)
}
const ticketId = ticket.id
```

### 1. Verify Ready

```bash
# Confirm not on main
git branch --show-current | grep -v '^main$'

# Confirm clean working tree
git status --porcelain

# Check for conflicts with main
git fetch origin main
git merge-base --is-ancestor origin/main HEAD || echo "CONFLICTS_POSSIBLE"
```

### 1b. Register Branch

Register the working branch with the pipeline API for automatic PR detection:

```typescript
// Get branch and repo info
const branch = execSync('git branch --show-current').toString().trim()
const remoteUrl = execSync('git remote get-url origin').toString().trim()
const repoMatch = remoteUrl.match(/github\.com[/:]([^/]+\/[^/.]+)/)
const repo = repoMatch ? repoMatch[1] : null

if (repo) {
  await client.registerBranch(ticketId, branch, repo)
}
```

This enables the reconciler to detect your PR even if subsequent API calls fail.

### 2. Handle Conflicts

If conflicts detected, present options:

```
⚠️ Branch may have conflicts with main.

Options:
A) Rebase onto main now
B) Continue anyway (resolve later)
C) Stop and investigate

Choice:
```

If rebase selected: `git rebase origin/main`

### 3. Determine Commit Prefix

From changes, select one:

- New feature → `feat:`
- Bug fix → `fix:`
- Tests only → `test:`
- Refactor → `refactor:`
- Docs → `docs:`

### 4. Generate PR Title

Format: `{prefix}: {concise description}`

- Max ~60 characters

From DrJKL/ticket-to-pr-pipeline, MIT.

More from DrJKL/ticket-to-pr-pipeline