Create Pull Request
!read references/usage.md
Gather Context
Run the gather script:
bash
python scripts/gather_context.py
Preconditions
Check these in the JSON output BEFORE proceeding:
- •Not on base branch: If
current_branchequalsbase_branch, STOP and say: "Error: Cannot create PR from the base branch. Create a feature branch first." - •Has commits: If
commitsarray is empty, STOP and say: "Error: No commits found. Make commits before creating a PR." - •No existing PR: If
existing_pris not null, STOP and say: "Error: PR already exists: <url>. Use /flow:pr-title or /flow:pr-desc to update it."
Execution
Create the PR:
bash
python scripts/create_pr.py --title "<title>" --body "<body>"
Title Format
- •Under 70 characters
- •Imperative mood (e.g., "Add feature" not "Added feature")
- •No period at end
- •Summarize the main change
Body Format
Use this exact structure:
code
## Summary - <bullet 1: main change, start with verb> - <bullet 2: supporting change or context> - <optional bullet 3-4 if needed>
Rules:
- •Each bullet starts with a verb (Add, Fix, Update, Remove, etc.)
- •Focus on WHAT and WHY, not HOW
- •No file paths unless the file itself is the feature
- •Do not include any watermark, attribution, or "Generated by" text
Output
After creating the PR, output:
code
Created PR #<number>: <title> <url>