---

name: pr description: Create a pull request with WSL-safe workflow. Uses --body-file to avoid heredoc permission corruption. disable-model-invocation: true argument-hint: "[branch-name]"

Create Pull Request

Create a PR from the current branch using WSL-safe patterns.

Process

1. Check state:

   • git status — note any uncommitted changes
   • git log main..HEAD — review commits to include
   • git diff main...HEAD --stat — files changed

2. Prepare:

   • If uncommitted changes exist, ask user whether to commit first
   • Push the branch directly from WSL: git push -u origin BRANCH (the Windows credential manager is wired into WSL git). Fallback ONLY if GCM crashes ("could not read Username"): powershell.exe -Command 'cd C:\Projects\cqs; git push -u origin BRANCH'

3. Write PR body to /mnt/c/Projects/cqs/pr_body.md:

   ## Summary
   - Bullet points summarizing changes
   
   ## Test plan
   - [ ] cargo test passes
   - [ ] cargo clippy clean
   - [ ] Manual verification steps
   

4. Create PR via PowerShell:

   powershell.exe -Command 'cd C:\Projects\cqs; gh pr create --title "..." --body-file pr_body.md'
   

5. Clean up: Delete pr_body.md

6. Wait for CI — pin the run ID (gh pr checks --watch latches onto the previous commit's completed run after a push; do not use it):

   sleep 45   # new run needs ~45s to register after the push
   powershell.exe -Command 'cd C:\Projects\cqs; gh run list --branch BRANCH --workflow CI --limit 1'
   powershell.exe -Command 'cd C:\Projects\cqs; gh run watch RUN_ID --exit-status'
   

7. Report: Show PR URL

Critical rules

• ALWAYS use --body-file — never inline heredocs in gh pr create --body
• Heredocs get captured as permission entries in settings.local.json, corrupting startup
• git push works directly from WSL (credential helper wired); PowerShell is the fallback when GCM crashes. All gh commands still go through PowerShell (with cd C:\Projects\cqs or -R jamie8johnson/cqs)
• main is protected — all changes require PR