GitHub PR Workflow

Detect VCS

First, determine which version control system is in use:

if [ -d ".jj" ]; then
  echo "jujutsu"
else
  echo "git"
fi

• If .jj exists: Read references/jujutsu.md for VCS-specific commands
• Otherwise: Read references/git.md for VCS-specific commands

Pre-flight Checks

The verification workflow must have passed before opening a PR. If using the issue-lifecycle skill, verification is already enforced — the link_pr method requires a passing attestation.

If working outside the issue lifecycle (e.g. a quick fix), run the verification workflow in the container sandbox before submitting. See agent-constraints/verification-conventions.md for the docker command.

Do not run lint/test/fmt manually as a pre-PR gate — the verification workflow covers all checks.

Create PR

After pushing changes (see VCS reference), create the PR:

gh pr create --head <branch-or-bookmark> --base main --title "Title here" --body "$(cat <<'EOF'
## Summary

Brief description of changes.

## Test Plan

- How the changes were tested
EOF
)"

Check Merge Status

To check if a PR is ready to merge:

# Check CI status
gh pr checks <pr-number>

# View PR details including review status
gh pr view <pr-number>

Handle Blocking Reviews

When a PR has blocking review feedback:

1. Get the review comments:

   gh pr view <pr-number> --comments
   

2. Enter plan mode to analyze the feedback and plan fixes

3. Implement the fixes

4. Push updates (see VCS reference for push commands)

5. Re-request review if needed:

   gh pr edit <pr-number> --add-reviewer <username>
   

Handle Suggestions

When reviewers provide non-blocking suggestions:

1. Get suggestions from the review:

   gh pr view <pr-number> --comments
   

2. Enter plan mode to evaluate each suggestion

3. Decide which suggestions to implement (discuss with user if unclear)

4. Implement approved suggestions and push

5. Respond to suggestions you chose not to implement with reasoning

Merge PR

Once all checks pass and reviews are approved:

# Squash merge (preferred)
gh pr merge <pr-number> --squash --delete-branch

# Or merge commit
gh pr merge <pr-number> --merge --delete-branch