# Rubric — Diagnosis (app-audit output)

Scores a **diagnosis** produced by `app-audit` — a root-caused correction and/or a repo-health diagnostic report. Measures whether the diagnosis finds the *true* root cause, ranks remediation by leverage, avoids the compound-fix gap, and grounds every claim in evidence. `[gate]` = mechanically checkable from the report text; `[review]` = judgment with cited evidence. The triage model scored against is in [triage-model.md](triage-model.md); the report template in [correction-loop.md](correction-loop.md).

| # | Dimension | Type | What it checks (evidence) | 1 (fail) → 3 (adequate) → 5 (excellent) |
|---|---|---|---|---|
| D1 | Recon grounding | [gate] | The six recon stop-questions answered, each tied to a command/file: tier+framework+rendering, version 3-tuple, ADR adoption, shells/hand-rolled inventory, doc currency, peer-mid-arc/open hand-off | 1: opens on findings with no inventory · 3: most answered, some unsourced · 5: all six answered, each grounded in a command or file |
| D2 | Evidence cited | [gate] | Every finding carries ≥1 `<file:line>` or grep line | 1: findings asserted bare · 3: most cite, some bare · 5: every finding carries file:line or grep output; none asserted |
| D3 | Root cause, not symptom | [review] | Each wrong-output symptom resolved to its irreducible source in the "happened because `<Layer-N>` does `<X>` when it should `<Y>` because `<reason>`" shape — not a surface patch | 1: restates the symptom / "fix the markup" · 3: a cause named but shallow · 5: irreducible source at the correct layer with a first-principles reason |
| D4 | Layer assignment | [review] | Symptom routed to the right layer (skill/codebase/substrate/spec) with one cited piece of evidence; the Light-DOM-vs-Shadow-DOM zeroth question run before any symptom probe | 1: assumes the surface layer is the origin · 3: a layer named, thin evidence · 5: layer cited with evidence + mechanism check done first |
| D5 | No compound-fix gap | [review] | For a compound bug shape, immediate + upstream + prevention-gate are all routed or explicitly deferred with rationale | 1: single-layer patch for a compound shape · 3: two of three routed · 5: all three routed (or deferred with reason); recurrence closed |
| D6 | Leverage-ranked remediation | [gate] | Each sweep carries an explicit leverage estimate; manifest-gap (class 0) sorts first; un-ranked gaps moved to out-of-scope | 1: flat unranked list · 3: ranked, leverage implied · 5: every sweep leverage-scored, class-0 first, low-leverage deliberately excluded |
| D7 | PATCH-scoped + verifiable | [review] | Each sweep fits one additive, non-breaking PATCH cut and names the gate that confirms it landed; bigger sweeps decomposed | 1: monolithic/breaking sweep, no gate · 3: scoped but the gate is vague · 5: each sweep one PATCH cut + a named verification gate |
| D8 | Hand-off discipline | [gate] | The report ends with a one-paragraph posture summary **and** an out-of-scope (considered-and-rejected) section; authoring waits on a confirmed plan | 1: no out-of-scope, proceeds to author · 3: summary present, thin out-of-scope · 5: bottom-line posture + out-of-scope rationale + explicit "confirm before authoring" |

**Gate to promote:** D1, D2, D6, D8 (the mechanical gates) must each score ≥ 3 — a diagnosis with no recon grounding (D1), unsourced findings (D2), an unranked gap list (D6), or no hand-off boundary (D8) is not actionable. **Hard cap:** if D3 (root cause) < 3, the artifact is a *symptom inventory*, not a diagnosis, and cannot promote regardless of the other scores — the skill exists to find the cause, not catalog the surface.

**Top failure to look for first:** a confident, well-evidenced, well-ranked remediation list with no root cause behind it (D2/D6 high, D3 low) — the symptom-patch that re-emerges in a new shape next turn.
