AI Coding Agent Metrics for Engineering Teams
Measure what matters when adopting AI coding tools. This skill provides metrics frameworks, measurement methodology, ROI models, and reporting templates for engineering managers, VPs of Engineering, and CTOs evaluating or scaling AI coding agents.
When to Use This Skill
- Evaluating AI coding tool ROI before or after purchase
- Building a metrics program for AI-assisted development
- Reporting AI tool impact to leadership or board
- Designing controlled experiments to measure AI effectiveness
- Comparing productivity across AI-equipped and traditional teams
- Tracking adoption health and identifying stall patterns
- Assessing quality impact of AI-generated code
- Running developer experience surveys for AI tools
Quick Reference
| Task |
Reference |
Asset |
| Track tool adoption |
adoption-metrics.md |
adoption-survey-template.md |
| Measure productivity |
productivity-metrics.md |
metric-dashboard-template.md |
| Monitor code quality |
quality-metrics.md |
metric-dashboard-template.md |
| Calculate ROI |
roi-framework.md |
roi-calculator-template.md |
| Assess developer experience |
developer-experience-metrics.md |
adoption-survey-template.md |
| Design experiments |
benchmarking-methodology.md |
experiment-design-template.md |
| Report to executives |
roi-framework.md |
executive-report-template.md |
| Measure AI coding impact |
this skill |
— |
| Context engineering for AI |
dev-context-engineering |
— |
| Per-task agent ROI |
ai-agents |
— |
| Observability for systems |
qa-observability |
— |
Core Metrics Taxonomy
Five measurement categories. Start with Adoption (you can't optimize what people aren't using), then layer in the others.
1. Adoption Metrics
Track whether and how developers use AI tools.
| Metric |
Formula |
Target (Mature) |
Source |
| License Utilization |
active_users / licensed_seats |
>85% |
License admin |
| DAU/WAU Ratio |
daily_active / weekly_active |
>0.6 |
Tool telemetry |
| Feature Breadth |
features_used / features_available |
>0.5 |
Tool telemetry |
| Acceptance Rate |
suggestions_accepted / suggestions_shown |
25-35% |
Copilot API / tool logs |
| Organic Usage Ratio |
voluntary_sessions / total_sessions |
>0.8 |
Survey + telemetry |
Deep dive: references/adoption-metrics.md — 8 additional metrics, adoption curve phases, tool-specific tracking, stall patterns.
2. Velocity Metrics
Measure speed and throughput changes.
| Metric |
Formula |
Expected AI Impact |
Source |
| Deploy Frequency |
deploys / time_period |
+15-30% |
CI/CD pipeline |
| Lead Time for Changes |
commit_to_production |
-20-40% |
Git + CI/CD |
| Cycle Time |
ticket_start_to_deploy |
-15-35% |
Project management + Git |
| PR Throughput |
merged_PRs / developer / week |
+20-40% |
Git platform |
| Time to First Commit |
onboard_date_to_first_commit |
-30-50% |
Git + HR data |
Deep dive: references/productivity-metrics.md — DORA adaptations, SPACE framework, cycle time decomposition, confounding variables.
3. Quality Metrics
Track whether AI helps or hurts code quality.
| Metric |
Formula |
Watch Direction |
Source |
| Bug Density |
bugs / KLOC |
Should decrease |
Issue tracker |
| Defect Escape Rate |
prod_bugs / total_bugs |
Should decrease |
Issue tracker |
| Rework Rate |
followup_PRs / total_PRs |
Watch for increase |
Git platform |
| Test Coverage |
covered_lines / total_lines |
Should increase |
CI coverage |
| Vulnerability Rate |
new_vulns / sprint |
Watch for increase |
SAST tools |
Critical warning: Early studies show mixed quality results. AI can increase velocity while also increasing bug density if guardrails are missing. Monitor both.
Deep dive: references/quality-metrics.md — complexity tracking, security metrics, technical debt, quality guardrails.
4. Economic Metrics
Calculate costs, benefits, and ROI.
| Metric |
Formula |
Benchmark |
Source |
| Cost per Seat |
(license + infra + training) / developers |
$20-50/dev/month |
Finance |
| Hours Saved/Dev/Week |
measured_or_estimated_time_savings |
2-8 hrs (varies widely) |
Survey + telemetry |
| ROI |
(net_benefits - costs) / costs × 100 |
100-300% yr1 (vendor data) |
Calculated |
| Payback Period |
total_investment / monthly_net_benefit |
2-6 months |
Calculated |
| Break-Even Adoption |
cost / (max_benefit × developers) |
25-40% of team |
Calculated |
Caveat: Most published ROI figures come from tool vendors. Independent studies show lower but still positive returns. Always triangulate.
Deep dive: references/roi-framework.md — cost model, value model, formulas, executive reporting, benchmarks with caveats.
5. Experience Metrics
Measure developer satisfaction and cognitive impact.
| Metric |
Formula |
Target |
Source |
| AI Tool Satisfaction |
survey_score (1-5 Likert) |
>3.8/5.0 |
Quarterly survey |
| Tool NPS |
promoters% - detractors% |
>30 |
Quarterly survey |
| Cognitive Load |
NASA-TLX adaptation (1-7) |
<4.0/7.0 |
Post-task survey |
| Give-Up Rate |
started_AI_finished_manual / total |
<20% |
Telemetry |
| Trust Calibration |
appropriate_review_rate |
>80% |
Code review data |
Deep dive: references/developer-experience-metrics.md — survey design, cognitive load measurement, friction indicators, trust metrics.
Measurement Maturity Model
Where is your organization in measuring AI coding impact?
| Level |
Name |
Characteristics |
Key Action |
| L0 |
No Measurement |
No tracking beyond license count |
Install basic telemetry, run first survey |
| L1 |
Basic Tracking |
License utilization + adoption rate tracked |
Add DORA metrics baseline, first ROI estimate |
| L2 |
Structured Program |
DORA + adoption + quality metrics active, quarterly survey |
Design controlled experiment, build dashboard |
| L3 |
Evidence-Based |
Controlled experiments, statistical rigor, executive reporting |
Cross-team benchmarking, predictive models |
| L4 |
Optimized |
Continuous measurement, automated dashboards, data-driven tool selection |
Industry benchmarking, publish findings |
L0 → L1 Quick Start (2 hours)
- Pull license utilization from admin console
- Run the adoption survey (assets/adoption-survey-template.md)
- Calculate basic ROI estimate (assets/roi-calculator-template.md)
- Present 1-page summary to leadership (assets/executive-report-template.md)
L1 → L2 (2-4 weeks)
- Establish DORA metric baselines (references/productivity-metrics.md)
- Set up quality tracking (references/quality-metrics.md)
- Build three-tier dashboard (assets/metric-dashboard-template.md)
- Schedule quarterly developer experience surveys
L2 → L3 (1-3 months)
- Design first controlled experiment (assets/experiment-design-template.md)
- Apply statistical rigor (references/benchmarking-methodology.md)
- Create executive reporting cadence (assets/executive-report-template.md)
- Cross-reference with dev-context-engineering maturity model for context quality impact
L3 → L4 (ongoing)
- Automate data collection and dashboards
- Build predictive models (adoption → productivity correlation)
- Benchmark against industry data
- Contribute findings to community (conference talks, blog posts)
Metric Selection Decision Tree
Not every org needs every metric. Start from what you're trying to prove.
WHAT ARE YOU TRYING TO PROVE?
│
├─ "Should we buy AI coding tools?"
│ └─ START: roi-framework.md → roi-calculator-template.md
│ Metrics: cost per seat, estimated hours saved, break-even adoption rate
│
├─ "Are developers actually using the tools?"
│ └─ START: adoption-metrics.md → adoption-survey-template.md
│ Metrics: DAU/WAU, acceptance rate, feature breadth, organic usage
│
├─ "Are we shipping faster?"
│ └─ START: productivity-metrics.md → metric-dashboard-template.md
│ Metrics: DORA metrics, cycle time, PR throughput
│
├─ "Is code quality suffering?"
│ └─ START: quality-metrics.md → metric-dashboard-template.md
│ Metrics: bug density, defect escape rate, rework rate, vulnerability rate
│
├─ "Are developers happy with AI tools?"
│ └─ START: developer-experience-metrics.md → adoption-survey-template.md
│ Metrics: satisfaction, NPS, cognitive load, give-up rate
│
├─ "How do we compare to industry?"
│ └─ START: benchmarking-methodology.md → experiment-design-template.md
│ Metrics: DORA benchmarks, adoption curves, ROI ranges
│
└─ "Should we expand or cut the program?"
└─ COMBINE: roi-framework.md + adoption-metrics.md + executive-report-template.md
Metrics: ROI trend, adoption trajectory, satisfaction trend, quality delta
Dashboard Design Principles
Three-Tier Hierarchy
| Tier |
Audience |
Refresh |
Metrics |
Purpose |
| Executive |
C-Suite, VP Eng |
Monthly |
4-6 KPIs |
Investment decision, program health |
| Team Lead |
Eng Managers |
Weekly |
8-10 metrics |
Team optimization, coaching |
| Developer |
Individual devs |
Real-time |
Personal stats |
Self-improvement (opt-in only) |
Design Rules
- Lead with outcomes, not activity — show deploy frequency, not lines of code
- Always show trend lines — a single number is meaningless without direction
- Include confidence indicators — mark metrics with low sample sizes or high variance
- Never rank individuals — aggregate to team level minimum (team size ≥5)
- Pair speed with quality — never show velocity without adjacent quality metrics
- Show cost alongside benefit — ROI is a ratio, not a cherry-picked benefit number
See: assets/metric-dashboard-template.md for full layout.
Anti-Patterns
| Anti-Pattern |
Why It's Harmful |
Fix |
| Lines of Code as productivity |
AI inflates LOC; rewards verbosity over clarity |
Use outcome metrics (features shipped, bugs resolved) |
| Individual developer tracking |
Creates surveillance culture, erodes trust |
Aggregate to team level, minimum team size 5 |
| Vanity metrics only |
"90% adoption!" means nothing if output quality drops |
Always pair adoption with quality and satisfaction |
| Measuring too early |
First 4 weeks are learning curve, not steady state |
Allow 8-12 week adoption curve before measuring impact |
| Vendor benchmarks as gospel |
Vendor studies select favorable conditions |
Triangulate with independent research; discount vendor data 30-50% |
| Ignoring the denominator |
"Shipped 40% more PRs" — but were they smaller? |
Normalize metrics (features/sprint, not PRs/sprint) |
| Correlation → causation |
Team adopted AI and got a new senior dev |
Use controlled experiments (benchmarking-methodology.md) |
| Surveying without acting |
Developers report friction → nothing changes |
Close the loop: share results + action plan within 2 weeks |
| One metric to rule them all |
Single metric always gets gamed |
Use balanced scorecard (adoption + velocity + quality + experience) |
| Comparing incomparable teams |
Frontend team vs infra team → meaningless comparison |
Segment by project type, stack, and task complexity |
Cross-References
Do / Avoid
Do:
- Start with adoption metrics — you can't optimize what people aren't using
- Establish baselines before rolling out AI tools (8-week minimum)
- Use the balanced scorecard approach (adoption + velocity + quality + experience)
- Run quarterly developer experience surveys
- Report with confidence intervals, not point estimates
- Cross-reference with context maturity (dev-context-engineering) — structured repos get more AI benefit
Avoid:
- Don't track individual developer productivity with AI tools
- Don't use lines of code as a metric for anything
- Don't measure impact in the first 4 weeks (adoption curve)
- Don't rely on vendor-published benchmarks without independent validation
- Don't survey developers without acting on the results
- Don't compare teams without controlling for confounding variables
- Don't present ROI without showing the cost model assumptions
Web Verification
55 curated sources in data/sources.json across 7 categories:
| Category |
Sources |
Key Items |
| Developer Productivity Research |
~10 |
DORA, SPACE, METR, ETH Zurich, McKinsey, Nicole Forsgren |
| AI Tool Adoption Data |
~8 |
GitHub Copilot studies, Stack Overflow, GitClear, Harvard BS |
| Industry Case Studies |
~8 |
Block/Square, Stripe, Klarna, Coinbase, Shopify, Amazon |
| Frameworks & Methodologies |
~8 |
DX Company, LinearB, Haystack, Jellyfish, Swarmia |
| Measurement Tools |
~7 |
Copilot Metrics API, OpenTelemetry, Grafana, PostHog |
| Consulting Reports |
~7 |
McKinsey, BCG, HBR, Gartner, Forrester |
| Academic Research |
~7 |
arXiv (Peng et al., Ziegler et al., METR), ACM, IEEE |
Verify current data before final answers. Priority areas:
- DORA State of DevOps report updates (annual)
- GitHub Copilot Metrics API changes
- New independent productivity studies (academic, not vendor)
- ETH Zurich context effectiveness research updates
- METR evaluation methodology updates
Fact-Checking
- Use web search/web fetch to verify current external facts, versions, pricing, tool features, or published benchmarks before final answers.
- Prefer independent/academic sources over vendor marketing; report source links and dates.
- If web access is unavailable, state the limitation and mark guidance as unverified.
Navigation
References
| File |
Content |
Lines |
| adoption-metrics.md |
Adoption tracking, curve phases, tool-specific data sources, stall patterns |
~300 |
| productivity-metrics.md |
DORA for AI teams, SPACE framework, cycle time decomposition |
~350 |
| quality-metrics.md |
Defect metrics, complexity, test coverage, security, technical debt |
~280 |
| roi-framework.md |
Cost/value models, ROI formulas, executive reporting, benchmarks |
~320 |
| developer-experience-metrics.md |
Satisfaction surveys, cognitive load, friction, trust, onboarding |
~260 |
| benchmarking-methodology.md |
A/B comparison, before/after design, statistical rigor, reporting |
~300 |
Assets (Copy-Ready Templates)
| File |
Purpose |
| metric-dashboard-template.md |
Three-tier dashboard layout (Executive / Team Lead / Developer) |
| adoption-survey-template.md |
15-question developer survey with Likert scales and scoring |
| roi-calculator-template.md |
Spreadsheet-ready ROI formulas and sensitivity analysis |
| executive-report-template.md |
Monthly 1-page + quarterly deep-dive report templates |
| experiment-design-template.md |
Controlled experiment planning with statistical requirements |
1---2name: dev-ai-coding-metrics3description: Measure and optimize AI coding agent impact — adoption tracking, DORA/SPACE for AI teams, ROI frameworks, DX surveys, benchmarking. Use when measuring AI tool effectiveness or building metrics programs.4---5
6# AI Coding Agent Metrics for Engineering Teams
7
8Measure what matters when adopting AI coding tools. This skill provides metrics frameworks, measurement methodology, ROI models, and reporting templates for engineering managers, VPs of Engineering, and CTOs evaluating or scaling AI coding agents.
9
10## When to Use This Skill
11
12- Evaluating AI coding tool ROI before or after purchase
13- Building a metrics program for AI-assisted development
14- Reporting AI tool impact to leadership or board
15- Designing controlled experiments to measure AI effectiveness
16- Comparing productivity across AI-equipped and traditional teams
17- Tracking adoption health and identifying stall patterns
18- Assessing quality impact of AI-generated code
19- Running developer experience surveys for AI tools
20
21## Quick Reference
22
23| Task | Reference | Asset |
24|------|-----------|-------|
25| **Track tool adoption** | adoption-metrics.md | adoption-survey-template.md |
26| **Measure productivity** | productivity-metrics.md | metric-dashboard-template.md |
27| **Monitor code quality** | quality-metrics.md | metric-dashboard-template.md |
28| **Calculate ROI** | roi-framework.md | roi-calculator-template.md |
29| **Assess developer experience** | developer-experience-metrics.md | adoption-survey-template.md |
30| **Design experiments** | benchmarking-methodology.md | experiment-design-template.md |
31| **Report to executives** | roi-framework.md | executive-report-template.md |
32| **Measure AI coding impact** | this skill | — |
33| **Context engineering for AI** | dev-context-engineering | — |
34| **Per-task agent ROI** | ai-agents | — |
35| **Observability for systems** | qa-observability | — |
36
37---
38
39## Core Metrics Taxonomy
40
41Five measurement categories. Start with Adoption (you can't optimize what people aren't using), then layer in the others.
42
43### 1. Adoption Metrics
44
45Track whether and how developers use AI tools.
46
47| Metric | Formula | Target (Mature) | Source |
48|--------|---------|-----------------|--------|
49| License Utilization | active_users / licensed_seats | >85% | License admin |
50| DAU/WAU Ratio | daily_active / weekly_active | >0.6 | Tool telemetry |
51| Feature Breadth | features_used / features_available | >0.5 | Tool telemetry |
52| Acceptance Rate | suggestions_accepted / suggestions_shown | 25-35% | Copilot API / tool logs |
53| Organic Usage Ratio | voluntary_sessions / total_sessions | >0.8 | Survey + telemetry |
54
55**Deep dive**: references/adoption-metrics.md — 8 additional metrics, adoption curve phases, tool-specific tracking, stall patterns.
56
57### 2. Velocity Metrics
58
59Measure speed and throughput changes.
60
61| Metric | Formula | Expected AI Impact | Source |
62|--------|---------|-------------------|--------|
63| Deploy Frequency | deploys / time_period | +15-30% | CI/CD pipeline |
64| Lead Time for Changes | commit_to_production | -20-40% | Git + CI/CD |
65| Cycle Time | ticket_start_to_deploy | -15-35% | Project management + Git |
66| PR Throughput | merged_PRs / developer / week | +20-40% | Git platform |
67| Time to First Commit | onboard_date_to_first_commit | -30-50% | Git + HR data |
68
69**Deep dive**: references/productivity-metrics.md — DORA adaptations, SPACE framework, cycle time decomposition, confounding variables.
70
71### 3. Quality Metrics
72
73Track whether AI helps or hurts code quality.
74
75| Metric | Formula | Watch Direction | Source |
76|--------|---------|----------------|--------|
77| Bug Density | bugs / KLOC | Should decrease | Issue tracker |
78| Defect Escape Rate | prod_bugs / total_bugs | Should decrease | Issue tracker |
79| Rework Rate | followup_PRs / total_PRs | Watch for increase | Git platform |
80| Test Coverage | covered_lines / total_lines | Should increase | CI coverage |
81| Vulnerability Rate | new_vulns / sprint | Watch for increase | SAST tools |
82
83**Critical warning**: Early studies show mixed quality results. AI can increase velocity while *also* increasing bug density if guardrails are missing. Monitor both.
84
85**Deep dive**: references/quality-metrics.md — complexity tracking, security metrics, technical debt, quality guardrails.
86
87### 4. Economic Metrics
88
89Calculate costs, benefits, and ROI.
90
91| Metric | Formula | Benchmark | Source |
92|--------|---------|-----------|--------|
93| Cost per Seat | (license + infra + training) / developers | $20-50/dev/month | Finance |
94| Hours Saved/Dev/Week | measured_or_estimated_time_savings | 2-8 hrs (varies widely) | Survey + telemetry |
95| ROI | (net_benefits - costs) / costs × 100 | 100-300% yr1 (vendor data) | Calculated |
96| Payback Period | total_investment / monthly_net_benefit | 2-6 months | Calculated |
97| Break-Even Adoption | cost / (max_benefit × developers) | 25-40% of team | Calculated |
98
99**Caveat**: Most published ROI figures come from tool vendors. Independent studies show lower but still positive returns. Always triangulate.
100
101**Deep dive**: references/roi-framework.md — cost model, value model, formulas, executive reporting, benchmarks with caveats.
102
103### 5. Experience Metrics
104
105Measure developer satisfaction and cognitive impact.
106
107| Metric | Formula | Target | Source |
108|--------|---------|--------|--------|
109| AI Tool Satisfaction | survey_score (1-5 Likert) | >3.8/5.0 | Quarterly survey |
110| Tool NPS | promoters% - detractors% | >30 | Quarterly survey |
111| Cognitive Load | NASA-TLX adaptation (1-7) | <4.0/7.0 | Post-task survey |
112| Give-Up Rate | started_AI_finished_manual / total | <20% | Telemetry |
113| Trust Calibration | appropriate_review_rate | >80% | Code review data |
114
115**Deep dive**: references/developer-experience-metrics.md — survey design, cognitive load measurement, friction indicators, trust metrics.
116
117---
118
119## Measurement Maturity Model
120
121Where is your organization in measuring AI coding impact?
122
123| Level | Name | Characteristics | Key Action |
124|-------|------|----------------|------------|
125| **L0** | No Measurement | No tracking beyond license count | Install basic telemetry, run first survey |
126| **L1** | Basic Tracking | License utilization + adoption rate tracked | Add DORA metrics baseline, first ROI estimate |
127| **L2** | Structured Program | DORA + adoption + quality metrics active, quarterly survey | Design controlled experiment, build dashboard |
128| **L3** | Evidence-Based | Controlled experiments, statistical rigor, executive reporting | Cross-team benchmarking, predictive models |
129| **L4** | Optimized | Continuous measurement, automated dashboards, data-driven tool selection | Industry benchmarking, publish findings |
130
131### L0 → L1 Quick Start (2 hours)
132
1331. Pull license utilization from admin console
1342. Run the adoption survey (assets/adoption-survey-template.md)
1353. Calculate basic ROI estimate (assets/roi-calculator-template.md)
1364. Present 1-page summary to leadership (assets/executive-report-template.md)
137
138### L1 → L2 (2-4 weeks)
139
1401. Establish DORA metric baselines (references/productivity-metrics.md)
1412. Set up quality tracking (references/quality-metrics.md)
1423. Build three-tier dashboard (assets/metric-dashboard-template.md)
1434. Schedule quarterly developer experience surveys
144
145### L2 → L3 (1-3 months)
146
1471. Design first controlled experiment (assets/experiment-design-template.md)
1482. Apply statistical rigor (references/benchmarking-methodology.md)
1493. Create executive reporting cadence (assets/executive-report-template.md)
1504. Cross-reference with dev-context-engineering maturity model for context quality impact
151
152### L3 → L4 (ongoing)
153
1541. Automate data collection and dashboards
1552. Build predictive models (adoption → productivity correlation)
1563. Benchmark against industry data
1574. Contribute findings to community (conference talks, blog posts)
158
159---
160
161## Metric Selection Decision Tree
162
163Not every org needs every metric. Start from what you're trying to prove.
164
165```text
166WHAT ARE YOU TRYING TO PROVE?
167 │
168 ├─ "Should we buy AI coding tools?"
169 │ └─ START: roi-framework.md → roi-calculator-template.md
170 │ Metrics: cost per seat, estimated hours saved, break-even adoption rate
171 │
172 ├─ "Are developers actually using the tools?"
173 │ └─ START: adoption-metrics.md → adoption-survey-template.md
174 │ Metrics: DAU/WAU, acceptance rate, feature breadth, organic usage
175 │
176 ├─ "Are we shipping faster?"
177 │ └─ START: productivity-metrics.md → metric-dashboard-template.md
178 │ Metrics: DORA metrics, cycle time, PR throughput
179 │
180 ├─ "Is code quality suffering?"
181 │ └─ START: quality-metrics.md → metric-dashboard-template.md
182 │ Metrics: bug density, defect escape rate, rework rate, vulnerability rate
183 │
184 ├─ "Are developers happy with AI tools?"
185 │ └─ START: developer-experience-metrics.md → adoption-survey-template.md
186 │ Metrics: satisfaction, NPS, cognitive load, give-up rate
187 │
188 ├─ "How do we compare to industry?"
189 │ └─ START: benchmarking-methodology.md → experiment-design-template.md
190 │ Metrics: DORA benchmarks, adoption curves, ROI ranges
191 │
192 └─ "Should we expand or cut the program?"
193 └─ COMBINE: roi-framework.md + adoption-metrics.md + executive-report-template.md
194 Metrics: ROI trend, adoption trajectory, satisfaction trend, quality delta
195```
196
197---
198
199## Dashboard Design Principles
200
201### Three-Tier Hierarchy
202
203| Tier | Audience | Refresh | Metrics | Purpose |
204|------|----------|---------|---------|---------|
205| **Executive** | C-Suite, VP Eng | Monthly | 4-6 KPIs | Investment decision, program health |
206| **Team Lead** | Eng Managers | Weekly | 8-10 metrics | Team optimization, coaching |
207| **Developer** | Individual devs | Real-time | Personal stats | Self-improvement (opt-in only) |
208
209### Design Rules
210
2111. **Lead with outcomes, not activity** — show deploy frequency, not lines of code
2122. **Always show trend lines** — a single number is meaningless without direction
2133. **Include confidence indicators** — mark metrics with low sample sizes or high variance
2144. **Never rank individuals** — aggregate to team level minimum (team size ≥5)
2155. **Pair speed with quality** — never show velocity without adjacent quality metrics
2166. **Show cost alongside benefit** — ROI is a ratio, not a cherry-picked benefit number
217
218See: assets/metric-dashboard-template.md for full layout.
219
220---
221
222## Anti-Patterns
223
224| Anti-Pattern | Why It's Harmful | Fix |
225|-------------|-----------------|-----|
226| **Lines of Code as productivity** | AI inflates LOC; rewards verbosity over clarity | Use outcome metrics (features shipped, bugs resolved) |
227| **Individual developer tracking** | Creates surveillance culture, erodes trust | Aggregate to team level, minimum team size 5 |
228| **Vanity metrics only** | "90% adoption!" means nothing if output quality drops | Always pair adoption with quality and satisfaction |
229| **Measuring too early** | First 4 weeks are learning curve, not steady state | Allow 8-12 week adoption curve before measuring impact |
230| **Vendor benchmarks as gospel** | Vendor studies select favorable conditions | Triangulate with independent research; discount vendor data 30-50% |
231| **Ignoring the denominator** | "Shipped 40% more PRs" — but were they smaller? | Normalize metrics (features/sprint, not PRs/sprint) |
232| **Correlation → causation** | Team adopted AI *and* got a new senior dev | Use controlled experiments (benchmarking-methodology.md) |
233| **Surveying without acting** | Developers report friction → nothing changes | Close the loop: share results + action plan within 2 weeks |
234| **One metric to rule them all** | Single metric always gets gamed | Use balanced scorecard (adoption + velocity + quality + experience) |
235| **Comparing incomparable teams** | Frontend team vs infra team → meaningless comparison | Segment by project type, stack, and task complexity |
236
237---
238
239## Cross-References
240
241| Skill | Relationship |
242|-------|-------------|
243| [dev-context-engineering](../dev-context-engineering/SKILL.md) | Context quality directly affects AI tool effectiveness — L0-L4 maturity model correlates with metric outcomes |
244| [ai-agents](../ai-agents/SKILL.md) | Per-task token economics and agent ROI (this skill covers team/org-level metrics) |
245| [qa-observability](../qa-observability/SKILL.md) | OpenTelemetry integration for automated metric collection |
246| [product-management](../product-management/SKILL.md) | OKR integration — AI metrics feed into engineering OKRs |
247| [startup-business-models](../startup-business-models/SKILL.md) | Unit economics context for ROI calculations |
248| [dev-workflow-planning](../dev-workflow-planning/SKILL.md) | Cycle time and planning metrics overlap |
249
250---
251
252## Do / Avoid
253
254**Do**:
255- Start with adoption metrics — you can't optimize what people aren't using
256- Establish baselines *before* rolling out AI tools (8-week minimum)
257- Use the balanced scorecard approach (adoption + velocity + quality + experience)
258- Run quarterly developer experience surveys
259- Report with confidence intervals, not point estimates
260- Cross-reference with context maturity (dev-context-engineering) — structured repos get more AI benefit
261
262**Avoid**:
263- Don't track individual developer productivity with AI tools
264- Don't use lines of code as a metric for anything
265- Don't measure impact in the first 4 weeks (adoption curve)
266- Don't rely on vendor-published benchmarks without independent validation
267- Don't survey developers without acting on the results
268- Don't compare teams without controlling for confounding variables
269- Don't present ROI without showing the cost model assumptions
270
271---
272
273## Web Verification
274
27555 curated sources in `data/sources.json` across 7 categories:
276
277| Category | Sources | Key Items |
278|----------|---------|-----------|
279| Developer Productivity Research | ~10 | DORA, SPACE, METR, ETH Zurich, McKinsey, Nicole Forsgren |
280| AI Tool Adoption Data | ~8 | GitHub Copilot studies, Stack Overflow, GitClear, Harvard BS |
281| Industry Case Studies | ~8 | Block/Square, Stripe, Klarna, Coinbase, Shopify, Amazon |
282| Frameworks & Methodologies | ~8 | DX Company, LinearB, Haystack, Jellyfish, Swarmia |
283| Measurement Tools | ~7 | Copilot Metrics API, OpenTelemetry, Grafana, PostHog |
284| Consulting Reports | ~7 | McKinsey, BCG, HBR, Gartner, Forrester |
285| Academic Research | ~7 | arXiv (Peng et al., Ziegler et al., METR), ACM, IEEE |
286
287Verify current data before final answers. Priority areas:
288- DORA State of DevOps report updates (annual)
289- GitHub Copilot Metrics API changes
290- New independent productivity studies (academic, not vendor)
291- ETH Zurich context effectiveness research updates
292- METR evaluation methodology updates
293
294## Fact-Checking
295
296- Use web search/web fetch to verify current external facts, versions, pricing, tool features, or published benchmarks before final answers.
297- Prefer independent/academic sources over vendor marketing; report source links and dates.
298- If web access is unavailable, state the limitation and mark guidance as unverified.
299
300---
301
302## Navigation
303
304### References
305
306| File | Content | Lines |
307|------|---------|-------|
308| adoption-metrics.md | Adoption tracking, curve phases, tool-specific data sources, stall patterns | ~300 |
309| productivity-metrics.md | DORA for AI teams, SPACE framework, cycle time decomposition | ~350 |
310| quality-metrics.md | Defect metrics, complexity, test coverage, security, technical debt | ~280 |
311| roi-framework.md | Cost/value models, ROI formulas, executive reporting, benchmarks | ~320 |
312| developer-experience-metrics.md | Satisfaction surveys, cognitive load, friction, trust, onboarding | ~260 |
313| benchmarking-methodology.md | A/B comparison, before/after design, statistical rigor, reporting | ~300 |
314
315### Assets (Copy-Ready Templates)
316
317| File | Purpose |
318|------|---------|
319| metric-dashboard-template.md | Three-tier dashboard layout (Executive / Team Lead / Developer) |
320| adoption-survey-template.md | 15-question developer survey with Likert scales and scoring |
321| roi-calculator-template.md | Spreadsheet-ready ROI formulas and sensitivity analysis |
322| executive-report-template.md | Monthly 1-page + quarterly deep-dive report templates |
323| experiment-design-template.md | Controlled experiment planning with statistical requirements |