Simple PR

Follow these steps to create a simple PR from staged changes:

Step 1: Check workspace state

Run: git status

Verify that all changes have been staged (no unstaged changes). If there are unstaged changes, abort and ask the user to stage their changes first with git add .

Also verify that we are on the main branch. If not, abort and ask the user to switch to main first.

Step 2: Ensure main is up to date

Run: git pull origin main

This ensures we're working from the latest code.

Step 3: Review staged changes

Run: git diff --cached

Review the staged changes to understand what the PR will contain.

Step 4: Generate commit message

Based on the staged changes, generate a concise commit message (1-2 sentences) that describes the "why" rather than the "what".

Display the proposed commit message to the user and ask for confirmation before proceeding.

Step 5: Create a new branch

Get the git username: git config user.name | tr ' ' '-' | tr '[:upper:]' '[:lower:]'

Create a short, descriptive branch name based on the changes (e.g., fix-typo-in-readme , add-retry-logic , update-deps ).

Create and checkout the branch: git checkout -b {username}/{short-descriptive-name}

Step 6: Commit changes

Commit with the message from step 3:

git commit -m "{commit-message}"

Step 7: Push and open a PR

Push the branch and open a PR:

git push -u origin {branch-name} gh pr create --title "{commit-message-title}" --body "{longer-description-if-needed}"

Report the PR URL to the user when complete.