ship

name	ship
description	Create a rich PR from planning artifacts (SUMMARY one-liners, requirement coverage, verification status).
allowed-tools	Read, Bash, Glob, Grep, AskUserQuestion
argument-hint	[--base <branch>] [--draft]

STOP -- DO NOT READ THIS FILE. You are already reading it. This prompt was injected into your context by Claude Code's plugin system. Begin executing Step 1 immediately.

/pbr:ship -- Create PR from Planning Artifacts

References: @references/ui-brand.md

You are the orchestrator for /pbr:ship. This skill generates a rich pull request from PBR planning artifacts -- SUMMARY one-liners, verification status, and requirement coverage. It uses gh pr create to open the PR.

Step 0 -- Immediate Output

Before ANY tool calls, display this banner:

+--------------------------------------------------------------+
|  PLAN-BUILD-RUN > SHIP                                       |
+--------------------------------------------------------------+

Then proceed to Step 1.

Step 1: Parse Arguments and Validate

1. Parse $ARGUMENTS for optional flags:
   • --base <branch> -- target branch for the PR (default: repo default branch)
   • --draft -- create as draft PR
2. Verify gh CLI is available: gh --version
3. Verify git working tree is clean. If uncommitted changes exist, warn:

   WARNING: You have uncommitted changes. Commit or stash before shipping.
   

   CRITICAL -- DO NOT SKIP: Present the following choice to the user via AskUserQuestion before proceeding: Use AskUserQuestion (pattern: yes-no): question: "Continue with uncommitted changes?" If "No": stop.
4. Verify current branch is NOT the default branch:

   git rev-parse --abbrev-ref HEAD
   

   If on main/master, warn and stop: "You are on the default branch. Create a feature branch first."

Step 2: Gather Planning Artifacts

1. Read .planning/STATE.md to get current phase info (phase number, slug, status)
2. Find the current phase directory: .planning/phases/{NN}-{slug}/
3. Read all SUMMARY-*.md files in the phase directory:
   • Extract status from frontmatter
   • Extract one-liner descriptions from the body (first non-heading, non-empty line after ## Task Results)
   • Collect commits arrays from frontmatter
4. Read VERIFICATION.md in the phase directory (if exists):
   • Extract score and status from frontmatter
   • Extract pass/fail counts
5. Read .planning/ROADMAP.md:
   • Extract requirements mapped to the current phase
   • Extract phase goal
6. Compute git stats:

   git diff --stat $(git merge-base HEAD main)..HEAD
   git log --oneline $(git merge-base HEAD main)..HEAD | wc -l
   

Step 3: Generate PR Body

Build the PR body with these sections:

## Summary

{Phase goal from ROADMAP.md}

{For each SUMMARY file: "- **Plan {NN}**: {one-liner status}" }

## Requirements

| REQ-ID | Description | Status |
|--------|-------------|--------|
{For each requirement mapped to this phase}

## Verification

- **Score**: {score from VERIFICATION.md or "Not verified"}
- **Status**: {status}
- **Must-haves**: {pass_count}/{total_count} passing

## Changes

- **Commits**: {commit_count}
- **Files changed**: {file_count}
- **Insertions**: +{insertions}
- **Deletions**: -{deletions}

---
Generated with [Plan-Build-Run](https://github.com/pibster/plan-build-run)

Step 4: Create PR

1. Generate a PR title from the phase: feat({phase-slug}): {phase goal summary}
   • Keep under 70 characters
   • Use appropriate commit type (feat, fix, refactor) based on phase goal keywords
2. Run gh pr create:

   gh pr create --title "{title}" --body "$(cat <<'PREOF'
   {generated body}
   PREOF
   )"
   

   • Add --base {branch} if --base flag was provided
   • Add --draft if --draft flag was provided
3. Capture and display the PR URL

Step 5: Display Result

PR created: {url}

  Title:    {title}
  Base:     {base branch}
  Status:   {draft or ready}
  Commits:  {count}
  Files:    {count}

Step 6: Next Steps

After displaying the PR result, always present a NEXT UP routing block:

╔══════════════════════════════════════════════════════════════╗
║  ▶ NEXT UP                                                   ║
╚══════════════════════════════════════════════════════════════╝

**PR created** — continue to the next phase or track progress

`/pbr:continue`

**Also available:**
- `/pbr:status` — see overall project status
- `/pbr:milestone` — if this was the last phase, complete the milestone

<sub>`/clear` first → fresh context window</sub>

Error Handling

• gh not installed: "Install GitHub CLI: https://cli.github.com/"
• Not a git repo: stop with error
• No planning artifacts found: "No SUMMARY files found. Run /pbr:build first."
• PR creation fails: show the gh error output and suggest fixes