draft-pull-request

# Draft Pull Request Create a draft pull request using `gh` CLI with a structured **What / Why / How** description that communicates the purpose and approach of your changes clearly. ## Usage ```bash /draft-pull-request [title] ``` - If a title is provided via `$ARGUMENTS`, use it as the PR title. - Otherwise, derive a concise title from the branch name and commit history. ## Process ### 1. Gather context ```bash # Detect the repository's default branch BASE_BRANCH=$(gh repo view --json defaultBranchRef -q '.defaultBranchRef.name') # Check current branch git branch --show-current # Review commit history since branching from base git log "$BASE_BRANCH"..HEAD --oneline # Review the full diff git diff "$BASE_BRANCH"..HEAD --stat git diff "$BASE_BRANCH"..HEAD ``` ### 2. Compose the PR description Write a structured description following the **What / Why / How** template: ```markdown ## What [Concise summary of the changes made. What was added, modified, or removed?] ## Why [The motivation behind this change. What problem does it solve? What opportunity does it capture?] ## How [Brief explanation of the approach taken. Key technical decisions, patterns used, or trade-offs made.] ## Checklist - [ ] Tests added or updated - [ ] Documentation updated - [ ] No breaking changes (or breaking changes documented above) ``` ### 3. Create the draft PR with gh CLI ```bash gh pr create \ --draft \ --title "<PR title>" \ --body "<structured what/why/how description>...