create-pr

Create pull requests with concise, useful descriptions.

Philosophy

• Be brief: No walls of text. Reviewers skim.
• Be specific: What changed and why, not how (code shows how).
• No fluff: Skip test plans, checklists, and boilerplate sections.

PR Title

Use format: <type>: <short description>

Types: fix, feat, refactor, docs, chore, test

Examples:

• fix: handle null user in session lookup
• feat: add workspace pause/resume
• refactor: extract terminal manager from agent

PR Description

Keep it short. 2-5 bullet points max.

## Summary

- <what changed>
- <why it changed>
- <any notable decisions or tradeoffs>

That's it. No "Test Plan", no "Screenshots", no checklists unless truly needed.

Steps

1. Check changed files:

   git diff --name-only main...HEAD
   

2. Run validation:

   bun run validate
   

3. Fix any issues found by validation before proceeding

4. Create PR (only after validation passes):

   gh pr create --title "<type>: <description>" --body "$(cat <<'EOF'
   ## Summary
   
   - <what>
   - <why>
   EOF
   )"
   

When to Add More

Only add extra sections if genuinely useful:

• Breaking changes: If API/behavior changes affect users
• Migration: If users need to do something
• Screenshots: Only for UI changes, and only if they help

Anti-patterns

• Long descriptions nobody reads
• Copy-pasting commit messages as bullets
• "This PR does X" (we know, it's a PR)
• Test plan sections (CI runs tests)
• Checklists (use CI for enforcement)