create-pr

# Create PR Create a high-quality PR to `main` that is easy to review, safe to merge, and explicit about risk. ## Canonical Implementation The bundled `scripts/create_pr.py` is the **preferred execution path** for Gates A–H: when Python 3 is available, run the gates through it (`references/bundled-script-guide.md`) instead of hand-executing the prose commands below. The prose workflow serves two roles — the **specification** the script must implement, and the **fallback** for environments without Python. If the two ever disagree, the prose specification wins and the script is the side to fix. Shared constants (size thresholds, confidence levels, gate statuses, secret-scan semantics) are consistency-tested in `scripts/tests/test_skill_contract.py` — update both sides together. The script distinguishes `blocks_publish` from `blocks_ready`. Repository identity/auth failures, publishing from `main`, unsafe branch state, incomplete diff/security evidence, high-confidence secret findings, and invalid PR titles are hard publication blockers: stop before `git push`. Quality, documentation, narrative, or compatibility gaps may still publish a draft, but never a ready PR. ## Quick Reference | Step | Gate | What it checks | Blocker? | |------|------|---------------|----------| | 1 | — | Scope the change | — | | 2 | **A** | GitHub auth, remote, base branch, branch protection | Yes | | 3 | **B** | Not on `main`, branch naming, no conflicts, synced with `origin/main` | Yes | | 4 | **...