All Metrics
Conformance Health · Layer 3

PRs
Evaluated

Count of design audits triggered by GitHub pull request events.

Formula
PRE = count(audits where
triggerType ∈ {GITHUB_PR_WEBHOOK,
GITHUB_PR_MANUAL})
Range: Integer·Automatic + manual PR audits
Signal states
RisingCoverage expanding — watch DCS
FlatCheck every repo is in scope
FallingCoverage regression — diagnose now

PRE is a volume count. It has no fixed thresholds — read it as a trend.

01

What it signals

PRE measures the breadth of CDA coverage across the development workflow. Every pull request that triggers a design audit — automatically via webhook or manually — is a PR whose architectural conformance was actually checked.

For open-source projects, a high PRE signals that community contributions are being evaluated for architectural conformance, not just code correctness.

A repository that never appears in the audit history is outside the governance boundary. PRE is how you notice.

02

How rkito produces it

Every design audit records what triggered it. PRE counts the audits triggered by GitHub pull request events — either the CDA webhook firing on a PR, or a PR audit run manually. For OSS projects, PRE is available as a public badge from /oss/:slug.

1
01
PR opened on a connected repository
The CDA webhook fires, or an audit is started manually for the PR
2
02
Design audit created
triggerType recorded as GITHUB_PR_WEBHOOK or GITHUB_PR_MANUAL
3
03
Lenses evaluated
The audit runs regardless of outcome — pass and fail both count
4
04
PRE incremented
Count of PR-triggered audits across the org's history
03

Who this metric is for

Architect
Design Authority
Is every repo inside the boundary?

A repository with no audit history is ungoverned by definition. PRE is the first check that CDA is actually wired into the places where architecture changes.

VP Eng
Engineering Leadership
Conformance at scale

As audit volume grows, more PRs means more opportunities for violations to surface. Read PRE alongside DCS to confirm conformance is holding as coverage expands.

OSS
Maintainers
Contributions, checked

For open-source projects, PRE shows that community pull requests are being evaluated for architectural conformance — not only for passing tests.

04

How this metric gets misused

⚠Do not use this metric to...

PRE is a coverage count, not a conformance score. A large PRE says that many PRs were checked. It says nothing about whether they passed. Always read it with DCS.

Do not compare PRE across orgs as a maturity ranking.

PRE scales with how many pull requests an org opens. What matters is whether it tracks your own PR volume — and whether any active repository is missing from it.

05

What to do as the trend moves

Step-by-step response playbook for each signal state.

RisingWatch DCS

More PRs are being evaluated. Make sure conformance holds as volume grows.

01

Navigate to /changecontrols/dashboard to confirm DCS is holding as audit volume grows. For OSS projects, surface PRE on /oss/:slug.

02

Monitor the DCS trend alongside PRE growth, and alert if DCS begins to decline as volume rises.

PlateauingCheck scope

Audit volume has stopped growing. Confirm every active repository is inside the governance boundary.

01

Navigate to /changecontrols/designaudits and review whether all expected repositories are contributing audits. Any repo missing from audit history is outside the governance boundary.

02

Check whether all active repositories have CDA webhooks configured, and add any missing repos to the governance scope.

FallingCoverage regression

Fewer PRs are being evaluated. Treat it as a governance coverage regression and diagnose it immediately.

01

Navigate to /changecontrols/designaudits and filter by triggerType = GITHUB_PR_WEBHOOK to confirm whether webhook-triggered audits have dropped.

02

Audit webhook configuration across all repositories. A falling PRE is a governance coverage regression that must be diagnosed and resolved immediately.

Start measuring yours

How many of your PRs get evaluated?

rkito counts PRE from your first PR-triggered design audit. Connect your repo and see how much of your workflow is inside the governance boundary.