create-linear-pr

Create Linear PR Workflow

Create a Linear ticket, branch from it, commit changes, and open a pull request.

Activate the linear skill first and use its wrapper scripts for all Linear operations. Do not call another Linear CLI directly from this workflow.

Context

• Current git status: !git status --short
• Current branch: !git branch --show-current
• Staged changes: !git diff --cached --stat
• Unstaged changes: !git diff --stat

Arguments

• $1 - Team identifier (e.g., ICE-T)
• $2 - Optional ticket title. If not provided, derive from the changes.

If team is missing, ask the user for it.

Prerequisites

• Changes should already be made to files (staged or unstaged)
• The linear skill must be available and its wrapper scripts must run successfully
• gh CLI must be authenticated

Steps

Track these steps as TODOs and complete them one by one.

1. Validate arguments - Ensure $1 (team) is provided.

   • If team is missing, ask the user for it.

2. Review changes - Analyze the context above to understand what will be committed.

   • If no changes exist (no staged or unstaged files), stop and inform the user.
   • Summarize the changes for the user.
   • If $2 (title) not provided, derive a concise title from the changes.

3. Create Linear ticket - Use the linear skill wrapper script:

   uv run .claude/skills/linear/scripts/create-ticket.py "<title from $2 or derived>" --team $1 --description "<auto-generated description>" --json
   

   • Generate a meaningful description based on the changes being committed.
   • Extract identifier, branchName, and url from the JSON response.

4. Create branch - Create and checkout the branch:

   git checkout -b <branchName from Linear response>
   

5. Stage and commit - Stage relevant changes and commit:

   git add <relevant files>
   git commit -m "$(cat <<'EOF'
   <TICKET-ID>: <title>
   
   <detailed description of changes>
   EOF
   )"
   

   • Always use HEREDOC for commit messages.
   • Include the ticket ID prefix.