ship

name	ship
description	Ship a Linear issue end-to-end: read issue, create Linear branch, implement, commit, push, open PR, and move issue to In Review. Trigger when the user provides a Linear issue ID (for example `ML-123`) and asks to implement/ship.

Ship Issue

Execute a Linear issue from input to PR with one default flow.

Input

• Required: Linear issue identifier like ML-123.

Default Mode (Only Mode)

• Branch name: use Linear branch name as-is.
• Commit title: [<ISSUE-ID>] <Issue Title>.
• PR title: match the commit title.

Workflow

Step 1: Read issue

Fetch issue details from Linear:

• title
• description
• branch name

Step 2: Create branch

git checkout main
git pull origin main
git checkout -b <resolved-branch-name>

Step 3: Implement

Use the issue description as scope.

Step 4: Commit

• Stage relevant files.
• Use commit title format: [<ISSUE-ID>] <Issue Title>.

Step 5: Push and open PR

git push -u origin <branch-name>

If a PR template exists, apply it first and append the generated summary after template content.

Choose a PR label. First, consult the repo's existing labels (gh label list) for a match based on issue type or content. If no suitable label is found, ignore label assignment.

Step 6: Return to main

git checkout main

Step 7: Update issue state

Move the Linear issue to In Review after PR creation.

Rules

• Commit and PR titles must match.
• Always return to main at the end.
• Always move issue to In Review.
• Run lint/tests before commit when possible.