Section 8 · OES Spec
Scorecard
A curated, presentation-ready view — not a dump of every metric.
The scorecard is the section that appears on a slide. It is curated by the analyst: the primary outcome, guardrail pass/fail, a few notable secondary effects, an overall verdict, and a recommended action. It is intentionally not the same as `results`.
Fields
| Field | Type | Purpose |
|---|---|---|
| scorecard.summary | string | Human-readable result summary. |
| scorecard.primaryOutcome | object | Result for the primary metric. |
| scorecard.guardrailOutcomes | object[] | Guardrail pass/fail summary. |
| scorecard.secondaryOutcomes | object[] | Notable secondary effects. |
| scorecard.qualityStatus | enum | valid, warning, invalid, needs_review. |
| scorecard.overallResult | enum | win, loss, neutral, mixed, inconclusive, invalid. |
| scorecard.recommendedAction | enum | ship, do_not_ship, iterate, rerun, continue_running, roll_back. |
| scorecard.keyFindings | string[] | Bullets for presentations and docs. |
| scorecard.risks | string[] | Known caveats. |
| scorecard.presentationNotes | string | Optional speaker notes. |
| scorecard.charts | object[] | Links to visual artifacts. |