Software Design

GitHub Pull Request Review Flow

State Diagrams · made in Skemio

State diagram of GitHub pull request review flow: Draft, In Review, Changes Requested, Approved, and Merged states.
State diagram of GitHub pull request review flow: Draft, In Review, Changes Requested, Approved, and Merged states.
Open it in SkemioMake your own

What it shows

  • Draft status protects WIP code from triggering CI builds and alerts.
  • Changes requested resets approval state and blocks accidental merge.
  • Branch protection rules enforce status checks before final commit.

The takeaway

Explicit review states remove ambiguity around who owns the next action on a PR.

More state diagrams