Create GitHub Pull Request

Execute automated PR creation workflow with comprehensive quality validation and security scanning.

Context

• Current git status: !git status

• Current branch: !git branch --show-current

• Unpushed commits: !git log @{u}..HEAD --oneline 2>/dev/null || git log --oneline -5

• GitHub authentication: !gh auth status

• Repository changes: !git diff --stat HEAD~1..HEAD 2>/dev/null || echo "No recent changes"

Requirements Summary

Ensure repository readiness with clean state and authentication. Complete all quality checks (lint, test, build, security) before PR creation. Link related issues with auto-closing keywords and apply accurate labels. See references/requirements.md for complete checklist.

Phase 1: Validation and Analysis

Goal: Validate repository state, analyze changes, detect templates, and identify blockers.

Actions:

• Verify GitHub authentication from context

• Check branch status and unpushed commits

• Analyze commit history for conventional commit compliance

• Identify changed files and determine PR scope

• Check for contributing guidelines (CONTRIBUTING.md ) and follow its requirements

• Detect PR templates (.github/PULL_REQUEST_TEMPLATE.md or root/docs locations)

• Detect potential blockers (merge conflicts, missing tests, etc.)

See references/repository-templates.md for template detection and compliance details.

Phase 2: Quality and Security Checks

Goal: Execute comprehensive quality validation and security scanning.

Actions:

• Run project-specific quality checks (see references/quality-validation.md for commands)

• Execute security scanning for sensitive files and hardcoded secrets

• Validate commit message format against standards

• If checks fail: follow failure resolution process in references/failure-resolution.md

• Re-run all checks until passing

Phase 3: PR Assembly and Creation

Goal: Create pull request with proper structure, metadata, and links.

Actions:

• Identify and link related issues using GitHub CLI

• Generate PR title (≤70 chars, imperative, no emojis)

• Assemble PR body following template in references/pr-structure.md

• Apply automated labels based on file changes

• Create PR using gh pr create with all metadata

• Report final PR URL and status to user

References

• Requirements: references/requirements.md

• Pre-creation checklist and commit standards

• Repository Templates: references/repository-templates.md

• Contributing guidelines and PR templates

• Quality Validation: references/quality-validation.md

• Node.js/Python validation commands

• PR Structure: references/pr-structure.md

• Title guidelines, body template, labels

• Failure Resolution: references/failure-resolution.md

• Agent collaboration for fixing failures

• Examples: references/examples.md

• Commit message examples