Create Pull Request

Comprehensive PR creation with validation. All output goes directly to GitHub PR.

Quick Start

/ork:create-pr /ork:create-pr "Add user authentication"

Argument Resolution

TITLE = "$ARGUMENTS" # Optional PR title, e.g., "Add user authentication"

If provided, use as PR title. If empty, generate from branch/commits.

$ARGUMENTS[0] is the first token (CC 2.1.59 indexed access)

STEP 0: Verify User Intent

BEFORE creating tasks, clarify PR type with AskUserQuestion:

• Feature: Full validation with all agents

• Bug fix: Focus on test verification

• Refactor: Skip new feature validation

• Quick: Skip all validation, just create PR

STEP 1: Create Tasks (MANDATORY)

Create tasks immediately to show progress:

TaskCreate(subject="Create PR for {branch}", description="PR creation with validation", activeForm="Creating pull request") TaskCreate(subject="Pre-flight checks", activeForm="Running pre-flight checks") TaskCreate(subject="Run validation agents", activeForm="Validating with agents") TaskCreate(subject="Run local tests", activeForm="Running local tests") TaskCreate(subject="Create PR on GitHub", activeForm="Creating GitHub PR")

Workflow

Phase 1: Pre-Flight Checks

Load: Read("${CLAUDE_SKILL_DIR}/rules/preflight-validation.md") for the full checklist.

BRANCH=$(git branch --show-current) [[ "$BRANCH" == "dev" || "$BRANCH" == "main" ]] && echo "Cannot PR from dev/main" && exit 1 [[ -n $(git status --porcelain) ]] && echo "Uncommitted changes" && exit 1

git fetch origin git rev-parse --verify "origin/$BRANCH" &>/dev/null || git push -u origin "$BRANCH"

Phase 2: Parallel Validation (Feature/Bug fix PRs)

Launch agents in ONE message. Load Read("${CLAUDE_SKILL_DIR}/references/parallel-validation.md") for full agent configs.

PR Type Agents to launch

Feature security-auditor + test-generator + code-quality-reviewer

Bug fix test-generator only

Refactor code-quality-reviewer only

Quick None

After agents complete, run local validation:

Adapt to project stack

npm run lint && npm run typecheck && npm test -- --bail

or: ruff check . && pytest tests/unit/ -v --tb=short -x

Phase 3: Gather Context

BRANCH=$(git branch --show-current) ISSUE=$(echo "$BRANCH" | grep -oE '[0-9]+' | head -1) git log --oneline dev..HEAD git diff dev...HEAD --stat

Phase 4: Create PR

Follow Read("${CLAUDE_SKILL_DIR}/rules/pr-title-format.md") and Read("${CLAUDE_SKILL_DIR}/rules/pr-body-structure.md") . Use HEREDOC pattern from Read("${CLAUDE_SKILL_DIR}/references/pr-body-templates.md") .

TYPE="feat" # Determine: feat/fix/refactor/docs/test/chore gh pr create --base dev
--title "$TYPE(#$ISSUE): Brief description"
--body "$(cat <<'EOF'

Summary

[1-2 sentence description]

Changes

• [Change 1]
• [Change 2]

Test Plan

• Unit tests pass
• Lint/type checks pass

Closes #$ISSUE

Generated with Claude Code EOF )"

Phase 5: Verify

PR_URL=$(gh pr view --json url -q .url) echo "PR created: $PR_URL"

CI Monitoring (CC 2.1.71)

After PR creation, schedule CI status monitoring:

Guard: Skip cron in headless/CI (CLAUDE_CODE_DISABLE_CRON)

if env CLAUDE_CODE_DISABLE_CRON is set, run a single check instead

CronCreate( schedule="*/5 * * * *", prompt="Check CI for PR #{pr_number}: gh pr checks {pr_number} --repo {repo}. All pass → CronDelete this job, report success. Any fail → alert with failure details." )

Handoff File

Write PR details for downstream skills:

Write(".claude/chain/pr-created.json", JSON.stringify({ "phase": "create-pr", "pr_number": N, "pr_url": "...", "branch": "...", "files_changed": [...], "related_issues": [...] }))

Rules

• NO junk files — Don't create files in repo root

• Run validation locally — Don't spawn agents for lint/test

• All content goes to GitHub — PR body via gh pr create --body

• Keep it simple — One command to create PR

Related Skills

• ork:commit — Create commits before PRs

• ork:review-pr — Review PRs after creation

References

Load on demand with Read("${CLAUDE_SKILL_DIR}/references/<file>") :

File Content

references/pr-body-templates.md

PR body templates

references/parallel-validation.md

Parallel validation agent configs

references/ci-integration.md

CI integration patterns

references/multi-commit-pr.md

Multi-commit PR guidance

assets/pr-template.md

PR template (legacy)