gh-pr-metadata

name

gh-pr-metadata

description

Update the current GitHub PR title and body for this repository so they match the repo's pull request template and conventional-commit title style. Use when a PR title is vague or misformatted, when the PR body is missing required sections or checklist items, when Codex needs to normalize PR metadata before review or merge, or when GitHub comments/checks indicate the PR title or body should be corrected.

GH PR Metadata

Overview

Normalize the current branch's GitHub PR metadata to this repo's expectations. Keep the title in conventional-commit style, keep the body aligned to .github/pull_request_template.md, and validate before handoff.

Ground the PR metadata in the live branch state, not stale branch names or old commit subjects. Always inspect the current branch diff versus its base before rewriting the PR title/body.

Read references/repo-pr-format.md when you need the exact section order, checklist items, or a title example.

Workflow

1. Resolve the current branch PR.

gh pr view --json number,title,body,url,headRefName,baseRefName

2. Inspect the current branch state against the PR base branch.

At minimum, check:

git diff --name-status origin/<base>...HEAD
git diff --stat origin/<base>...HEAD
git log --oneline --decorate --no-merges origin/<base>..HEAD

Use these to answer:

• what files actually differ from the base right now
• which changes are functional versus cleanup/tooling/docs
• whether the existing PR title/body still matches the current branch after rebases, reverts, or scope narrowing