Skip to content

Commit a91954a

Browse files
authored
chore: improve executive objective report (#39490)
1 parent 0f51757 commit a91954a

2 files changed

Lines changed: 43 additions & 14 deletions

File tree

.github/workflows/objective-impact-report.lock.yml

Lines changed: 3 additions & 3 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

.github/workflows/objective-impact-report.md

Lines changed: 40 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
emoji: 📊
3-
description: Impact efficiency report from workflow outcomes and linked objectives.
3+
description: Executive impact efficiency report from workflow outcomes tied to tracked objectives.
44
on:
55
workflow_dispatch:
66
permissions:
@@ -19,9 +19,9 @@ safe-outputs:
1919

2020
## Goal
2121

22-
POC: Test whether Impact Efficiency is a more meaningful signal than accepted outcome counts alone.
22+
Produce a comprehensive executive report on what work was performed, what AIC tokens were spent on, and which outcomes delivered the highest impact. The report must clearly answer: *What did we build, fix, and ship — and was it worth the cost?*
2323

24-
Focus only on **pull request outcomes** and **safe output outcomes** (issues created or closed via the safe-output mechanism). Other outcome types are excluded from this POC because their acceptance criteria are not yet well-defined and most remain pending.
24+
Focus only on **pull request outcomes** and **safe output outcomes** (issues created or closed via the safe-output mechanism). Other outcome types are excluded because their acceptance criteria are not yet well-defined and most remain pending.
2525

2626
Use this model:
2727

@@ -59,7 +59,7 @@ If a run's `aic` field is missing or null, treat it as `0` and count it as missi
5959

6060
Analyze only the following outcome types from the last 180 days:
6161

62-
- **Pull request outcomes**: PRs created by GitHub Agentic Workflow runs. Accepted = merged. Rejected = closed without merge. Skip open (pending) PRs.
62+
- **Pull request outcomes**: PRs created by GitHub Agentic Workflow runs **that have a linked closing issue** (`Closes #N`). Accepted = merged. Rejected = closed without merge. Skip open (pending) PRs. **Exclude entirely** any PR without a traceable linked issue — do not fall back to PR labels.
6363
- **Safe output outcomes**: issues created or closed by workflow runs via the safe-output mechanism. Accepted = issue successfully created/closed. Skip any with unresolved state.
6464

6565
Exclude all other outcome types (direct issue outcomes, comments, discussions, etc.). These are omitted because their acceptance criteria are incomplete and most are left pending, which would distort the metric.
@@ -91,11 +91,11 @@ If a traced root object has no labels that exist in the mapping, mark the outcom
9191

9292
For each in-scope outcome, follow the implemented root-tracing behavior:
9393

94-
1. For pull-request outcomes, trace the PR to its linked closing issue and use that root issue's labels.
95-
2. If PR root tracing fails, use labels on the PR itself.
94+
1. For pull-request outcomes, trace the PR to its linked closing issue (`Closes #N`) and use that root issue's labels.
95+
2. If PR root tracing fails (no linked closing issue found), **exclude the PR from analysis entirely**. Do not fall back to PR labels. Count it in the "PRs excluded (no linked issue)" total.
9696
3. For safe-output issue outcomes, use labels on the safe-output issue itself.
9797
4. Record the traced root URL when one is found so the report preserves an audit trail.
98-
5. If no mapped objective labels can be found, mark the outcome as `unmapped`, exclude it from `Σ Outcome Value`, and report it separately.
98+
5. If no mapped objective labels can be found after tracing, mark the outcome as `unmapped`, exclude it from `Σ Outcome Value`, and report it separately.
9999

100100
## Computation
101101

@@ -141,27 +141,54 @@ Impact Efficiency Report - YYYY-MM-DD
141141

142142
The report must include:
143143

144+
### Executive Summary
145+
146+
Write 2–4 sentences that directly answer: *What did we work on, what was the highest-impact work, and how efficiently were AIC tokens spent?* Highlight the most impactful objective categories and call out any significant gaps (e.g., large AIC spend with no mapped objective value).
147+
144148
### Summary
145149

146-
- PR outcomes analyzed (merged / closed / excluded open)
150+
| Metric | PRs | Safe-output Issues | Combined |
151+
|---|---:|---:|---:|
152+
153+
Include:
154+
155+
- PRs analyzed with linked issue (merged / closed / excluded open)
156+
- PRs excluded (no linked closing issue)
147157
- Safe output outcomes analyzed
148-
- Objectives mapped
158+
- Outcomes mapped to objectives
149159
- Unmapped outcomes
150160
- Accepted outcome count
151161
- Total outcome value
152162
- AI Credits
153163
- Impact Efficiency
154164

165+
### What We Worked On
166+
167+
Group all **accepted, mapped** outcomes by objective category (the highest-value objective label from the mapping). For each category, list:
168+
169+
- Objective category name and its mapping value
170+
- Number of accepted outcomes in this category
171+
- Total outcome value contributed
172+
- AIC consumed by outcomes in this category
173+
- Impact Efficiency for this category (total outcome value / AIC consumed)
174+
- Representative examples (up to 3 linked outcomes)
175+
176+
Sort categories by total outcome value descending. Also call out separately which category consumed the **most AIC** (highest denominator cost), so readers can see where budget was spent regardless of value delivered.
177+
155178
### Top outcomes by outcome value
156179

157-
| Outcome | Type | Associated objective | Objective Value | Outcome Value |
180+
| Outcome | Type | Root / Associated Objective | Objective Value | Outcome Value |
158181
|---|---|---|---:|---:|
159182

183+
List the top 15 outcomes with highest Outcome Value. Include a link to the PR or issue.
184+
160185
### Unmapped outcomes
161186

162187
| Outcome | Type | Reason objective was not mapped |
163188
|---|---|---|
164189

190+
Only include outcomes that were in scope (linked-issue PRs and safe-output issues) but had no matching label in the objective mapping. Do not include PRs that were excluded for lacking a linked issue — those are already counted in "PRs excluded".
191+
165192
### Interpretation
166193

167194
Compare:
@@ -171,11 +198,13 @@ Compare:
171198

172199
Explain which one better reflects meaningful delivered value relative to cost.
173200

201+
Call out the most significant finding: which objective category delivered the most value per AIC? Which categories consumed AIC with little or no mapped value?
202+
174203
### Data quality
175204

176205
Mention missing or weak links in:
177206

178-
- PR root tracing and linked-closing-issue coverage
207+
- PR root tracing and linked-closing-issue coverage (count of PRs excluded for lacking a linked issue)
179208
- safe-output issue label mapping coverage in `.github/objective-mapping.json`
180209
- AI Credits availability
181210

0 commit comments

Comments
 (0)