create-pr

Create a GitHub pull request from the current branch using gh CLI. Reads chalk.json for project context to generate better test instructions and embeds visual artifacts if available.

Workflow

1. Check prerequisites — Run git status to verify:

   • Not on main/master (if so, warn and suggest creating a branch)
   • No uncommitted changes (if there are, suggest running /commit first)
   • Branch has commits ahead of base branch

2. Analyze changes — Run git log main..HEAD --oneline and git diff main...HEAD --stat to understand all changes.

3. Read project context — Read .chalk/chalk.json if it exists:

   • test.command — for test plan instructions
   • dev.command — for setup instructions
   • routes — to identify affected pages
   • project.framework — for framework-specific review notes

4. Determine base branch — Default to main. If the user specifies a different target, use that.