Working agreements

Process & agreements

What it measures

Weekly adherence to the team's own agreements — review within N hours, max PR size, WIP limit, max PR age, and approval-before-merge — each as a percentage of PRs that met the bar.

Why it matters

These are the team's own rules, not git-pulse's. Tracking adherence turns informal norms into a visible, improvable signal the team set for itself.

How to read it

  • Each agreement is a separate line; a value of 100% means every PR met it that week.
  • Thresholds live in gitpulse.yml — set 0/false to disable any check the team hasn't agreed to.

Anti-blame

Breaches are listed without authors. The approval-before-merge check is trend-only — never drilled down — because that drill-down could re-identify people.

Common misreads

  • Draft PRs cannot breach review-within or max-age — the clock starts when the author marks the PR ready for review; draft state is read at sync time (a whole-interval approximation).
  • Drafts still count toward the WIP limit — they are active work, just not yet reviewable.
  • When size scaling is configured, the review-within and max-age thresholds stretch for larger PRs (e.g. XL PRs get a multiple of the base window) — so a big change isn't unfairly flagged. The breach drilldown shows each PR's size-specific cap.