pr-merge

# PR Merge

## Purpose
Merge GitHub pull requests with strict CI validation and merge state checking.
Enforces the rule: **NEVER bypass failed CI checks**. Only offers bypass for missing reviews when all checks pass.

## Quick Reference
- **Setup**: `/pr-merge configure` (set merge strategy and branch cleanup)
- **Usage**: `/pr-merge` or `/pr-merge <number>`
- **Config**: Depends on installation model (see Save Location)
- **Requires**: GitHub CLI installed and authenticated, PR exists for branch

## Commands

| Command | Purpose | When to Use |
|---------|---------|-------------|
| `/pr-merge configure` | Set merge strategy and branch cleanup | First time in a project |
| `/pr-merge` | Merge PR for current branch | Normal usage |
| `/pr-merge <number>` | Merge specific PR by number | When not on the PR branch |

---

## /pr-merge configure

**When**: First time using `/pr-merge` in a project, or to change merge preferences

**What it does**:
1. Asks user for preferred merge strategy (squash, merge, rebase)
2. Asks whether to delete branch after merge
3. Saves config to yaml (installation-model-aware path)

### Workflow

```
1. ASK MERGE STRATEGY
   └─ squash (default), merge, or rebase?

2. ASK BRANCH CLEANUP
   └─ Delete branch after merge? (default: true)

3. SAVE CONFIG
   └─ Write pr-merge.yaml with preferences
```

### Save Location

Config path depends on the installation model. Detect which model is active by checking whether this skill is running from inside `.claude/skills/pr-merge/` (my-workflow) or from an external plugin directory (standalone).

| Installation Model | Config File | How to Detect |
|--------------------|-------------|---------------|
| **Standalone** (external plugin) | `.claude/skills/pr-merge.yaml` | Skill files are NOT inside `.claude/skills/pr-merge/` |
| **my-workflow** (copied into project) | `.claude/skills/pr-merge/pr-merge.yaml` | Skill files ARE inside `.claude/skills/pr-merge/` |

**Precedence when reading** (first found wins)