Most AI-impact numbers in circulation are theater: acceptance rates, lines generated, self-reported hours saved. This playbook designs the honest system — every speed metric paired with a quality metric, team-level rollups only, a pre-rollout baseline, a running confound log, and an explicit written ban on the vanity numbers.
Workflow area: Measurement & ROI · Tier: Advanced · Hands-on time: ~45 minutes to design
The pressure to produce an AI-impact number is enormous — the CFO wants ROI, the board wants a percentage, the vendor supplies one helpfully pre-calculated. The trap is that the easy numbers are the meaningless ones: acceptance rate measures how often engineers accept suggestions, not whether those suggestions survived review, shipped, or caused incidents; lines of code has never measured anything except lines of code. An honest system is slower and less quotable, and it is the only thing that survives a skeptical audit — which is precisely what makes it valuable (pb-39 spends this credibility).
Choose paired metrics — no speed without its quality partner. Every velocity claim ships handcuffed to the metric that would expose its cost:
PAIR 1: Change lead time ↔ Change failure rate
PAIR 2: PR throughput ↔ Revert/hotfix rate on those PRs
PAIR 3: Time-to-merged ↔ Escaped defects per release
PAIR 4: Delivery pace (survey) ↔ Maintainability confidence (survey)
Frameworks exist so you don't invent this from scratch: DX Core 4 or SPACE both force the balance across speed, quality, and developer experience. The rule is structural — any report showing one side of a pair without the other is incomplete by definition, and the template should make that visually obvious.
Capture the baseline before the tools land. Minimum one clean quarter of the paired metrics, at team granularity, with the measurement definitions frozen and written down ("deploy means X, counted by Y"). If the rollout already happened, say so in every report forever — a reconstructed baseline is an estimate and must be labeled one; the honest phrase is "we cannot cleanly attribute the pre/post delta," and it costs less credibility than one debunked chart.
Run the confound log as measurement infrastructure. The same log as pb-36, promoted to first-class citizen: dated entries for reorgs, holidays, attrition, incident weeks, freezes, definition changes, and each rollout stage. Every impact report gets a confound section generated against this log, and any delta smaller than its confounds gets reported as "within noise" — writing "no detectable effect yet" in month two is what makes "detectable effect" believable in month six.
Roll up at team level, compare only self-to-self. Team-level aggregates, trended against that team's own baseline — never team-vs-team league tables, which measure codebase age and domain difficulty while claiming to measure AI benefit, and never per-person cuts (pb-38 sets the floors). Complement the telemetry with a quarterly survey (SPACE-style satisfaction and friction questions), because engineers can see impact and damage that pipelines cannot: "the code ships faster and I trust it less" is a finding no DORA metric will ever emit.
Publish the ban list — in writing, with reasons. A short section in the measurement doc, signed by you:
NOT ACCEPTED AS IMPACT EVIDENCE:
- Suggestion acceptance rate (measures acceptance, not value;
gameable by config; vendor-favored for a reason)
- Lines/volume of AI code (volume is cost, not benefit)
- Self-reported hours saved (uncontrolled, demand-biased;
usable as sentiment, never as ROI arithmetic)
- Any per-person productivity figure (see telemetry policy)
The ban does double duty: it pre-empts the vendor QBR slide, and it tells your engineers in writing that you know the difference — which is worth more adoption goodwill than any launch email.
Report on a cadence with the pb-36 brief attached. Quarterly impact reports: the pairs, self-comparisons against baseline, the confound section, survey themes, and the honest headline — which for the first two quarters is usually "early, mixed, and within noise for most teams." Resist the interim extrapolation; the system's whole value is that when it finally does show a clean effect, nobody can argue with it.
Impact measurement runs on the same telemetry that could rank individuals — enforce team-level aggregation floors, disable per-person views in every platform involved, and put the measurement's published purpose in writing before collection starts; the full trust contract is pb-38, and this system is only as honest as that contract is intact.
Pair every speed metric with its quality cost, freeze a baseline, log the confounds, ban the vanity numbers in writing, and let "within noise" appear as often as it's true — the honest system is slower to produce a headline, and that is exactly why its headline, when it comes, will hold.