For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /packs/shared/git/pull-requests.md.
Quick start

Pull requests

Give a reviewer one coherent change and enough evidence to assess it.

Review contract

Why

Continuing a change in its existing review preserves the relationship between feedback and fixes.

Rules

  • MUST describe the change, its reason, and the affected contracts. [review]
  • MUST include a testing section with exact commands and observed outcomes. [review]
  • MUST identify checks that were unavailable or not run. [review]
  • MUST review the complete diff before requesting review. [review]
  • MUST mark unfinished work as a draft. [review]
  • MUST keep follow-up work for the same change in the existing review. [review]
  • MUST use URLs returned by the hosting tool rather than invent them. [review]
  • MUST follow the consumer's merge, publishing, and history-rewrite policy. [review]

[review]

Required checks and hosting protections enforce configured gates. Review establishes scope and the accuracy of verification claims.

Enforcement

Required checks and hosting protections enforce configured gates. Review establishes scope and the accuracy of verification claims.