Problem
The assessor's real deliverable is the export, but the score→opinion/rubric mapping is implemented separately in src/utils/auditReportMarkdown.js:237-284 and src/utils/executiveSummaryPDF.js:154 (and CSV export has its own path). The audit-report coherence fix (opinion-vs-math contradictions) addressed symptoms; the structure that produced them remains.
Proposal
- Extract a single
scoreRubric module (0–10 scale → rating bands → opinion text) with unit tests.
- All exports (PDF, markdown, CSV) consume it.
- Add a one-page board-ready summary export: top gaps, trend vs target, recommended next actions.
Value
Consistent numbers across every artifact a practitioner hands to management — the thing the tool is ultimately judged on.
Problem
The assessor's real deliverable is the export, but the score→opinion/rubric mapping is implemented separately in
src/utils/auditReportMarkdown.js:237-284andsrc/utils/executiveSummaryPDF.js:154(and CSV export has its own path). The audit-report coherence fix (opinion-vs-math contradictions) addressed symptoms; the structure that produced them remains.Proposal
scoreRubricmodule (0–10 scale → rating bands → opinion text) with unit tests.Value
Consistent numbers across every artifact a practitioner hands to management — the thing the tool is ultimately judged on.