creating-pull-requests

[Explain the motivation for this change. What problem does it solve? What feature does it enable?]

[Explain why this implementation was chosen over alternatives. What trade-offs were considered?]

[Describe the technical implementation. How does the code achieve the goal?]

• [Ticket](url) or JIRA-123
• [Slack thread](url)

```

# Step-by-Step Process

Before creating the PR, understand what's being changed:

```bash

# See all commits on this branch vs main

git log main..HEAD --oneline

# See the full diff

git diff main...HEAD

# Check current branch name

git branch --show-current

```

Ask the user or search for:

• Jira/ticket numbers (look in commit messages or branch name)
• Related Slack conversations
• Fusion run URLs
• GCS paths for data or artifacts

```bash

gh pr create --title "Add feature X to service Y" --body "$(cat <<'EOF'

[Motivation here]

[Implementation rationale here]

[Technical details here]

• [Ticket](url)

EOF

)"

```

# Example

Branch: feature/add-retry-logic

Commits: Adds exponential backoff retry to HTTP client

Title: Add exponential backoff retry to HTTP client

Description:

```markdown

HTTP requests to external services occasionally fail due to transient network issues. Without retry logic, these failures cascade to users as errors.

Chose exponential backoff over fixed-interval retry to avoid thundering herd problems during partial outages. Used a max of 3 retries with jitter to spread out retry attempts.

Wraps the existing HTTP client with a retry decorator. On 5xx responses or network errors, waits 2^attempt * 100ms + random(0-50ms) before retrying. Logs each retry attempt for observability.

• [PROJ-1234](https://jira.example.com/browse/PROJ-1234)
• [Slack discussion](https://slack.com/archives/...)

```

# CLI Commands

```bash

# Create PR interactively

gh pr create

# Create with title and body

gh pr create --title "Add X" --body "Description here"

# Create as draft

gh pr create --draft --title "Add X" --body "..."

# Create with specific base branch

gh pr create --base develop --title "Add X" --body "..."

# Create and immediately open in browser

gh pr create --title "Add X" --body "..." --web

```

# Validation Checklist

Before creating the PR, verify:

• [ ] Title uses active voice with present-tense verb
• [ ] Description has Why, Approach, and How sections
• [ ] All relevant links are included
• [ ] No AI/Claude attribution anywhere
• [ ] No Co-Authored-By headers in commits