GitHub Pull Request Workflow

Ship a PR a reviewer can land without follow-up clarifying questions. The aim is high signal in the title and body, evidence the change works, and clean replies when feedback comes in.

When to use

• You are about to open a PR for a change that is functionally complete.
• A reviewer left comments and you need to respond and push fixes.
• A PR has been open more than a day and needs to be brought back into shape (stale conflicts, missing description, missing verification).

When not to use

• The change is not yet functionally complete. Finish the work first; draft PRs that bounce on review are noise.
• The repository uses a non-GitHub forge. Adjust to that forge's conventions; do not force GitHub-isms.

Branch hygiene before opening