{
  "rows": [
    {
      "id": "scorecard",
      "canonical": "scorecard",
      "family": "score-debt",
      "kind": "subsystem",
      "definition": "One deterministic measurement of a surface that folds reality into a single *_debt integer plus an A-F grade (the family is documented in the scorecard skill).",
      "distinction": "The per-surface MEASUREMENT - NOT the control pane (the fold that sums every *_debt) and NOT a single *_debt integer it emits.",
      "distinct_from": ["control-pane", "disambiguation-debt"],
      "aliases": [],
      "grounding": "scorecard",
      "grounding_kind": "doc",
      "glossary_anchor": "docs/fak/concept-glossary.md",
      "parent": "",
      "verdict": "crystal",
      "gaps": []
    },
    {
      "id": "control-pane",
      "canonical": "scorecard control pane",
      "family": "score-debt",
      "kind": "subsystem",
      "definition": "The fold that sums every scorecard's *_debt into one portfolio number with a pinned ratchet that reds only on a regression above baseline.",
      "distinction": "The FOLD over all scorecards - NOT a single scorecard (one surface) and NOT a single *_debt integer (one metric).",
      "distinct_from": ["scorecard", "disambiguation-debt"],
      "aliases": ["controlpane"],
      "grounding": "controlpane",
      "grounding_kind": "symbol",
      "glossary_anchor": "docs/fak/concept-glossary.md",
      "parent": "",
      "verdict": "crystal",
      "gaps": []
    },
    {
      "id": "disambiguation-debt",
      "canonical": "disambiguation-debt",
      "family": "score-debt",
      "kind": "metric",
      "definition": "This scorecard's integer: clarity defects of positioned concepts plus coverage gaps (confusable tree tokens with no row).",
      "distinction": "NAMING clarity (distinct names for distinct concepts) - NOT conflation-debt (provenance honesty: a number labeled WITNESSED vs OBSERVED), the other easily-confused honesty axis.",
      "distinct_from": ["scorecard", "control-pane"],
      "aliases": [],
      "grounding": "debt",
      "grounding_kind": "doc",
      "glossary_anchor": "docs/fak/concept-glossary.md",
      "parent": "scorecard",
      "verdict": "crystal",
      "gaps": []
    },
    {
      "id": "scorecardpane-native-fold",
      "canonical": "scorecardpane (native control-pane fold)",
      "family": "score-debt",
      "kind": "subsystem",
      "definition": "The Go package that ports the scorecard control-pane and repo-hygiene folds into the fak binary for faster local and garden checks.",
      "distinction": "The native IMPLEMENTATION package - NOT the control-pane concept it computes and NOT an individual scorecard's own payload.",
      "distinct_from": ["control-pane", "scorecard"],
      "aliases": ["scorecardpane"],
      "grounding": "scorecardpane",
      "grounding_kind": "symbol",
      "glossary_anchor": "",
      "parent": "control-pane",
      "verdict": "defined",
      "gaps": []
    },
    {
      "id": "repo-hygiene-scorecard",
      "canonical": "repo-hygiene scorecard",
      "family": "score-debt",
      "kind": "subsystem",
      "definition": "The scorecard that measures repository hygiene debt: noisy artifacts, placement drift, generated junk, and other tree-cleanliness defects.",
      "distinction": "One hygiene MEASUREMENT surface - NOT the control pane that folds all scorecards and NOT the total_debt sum.",
      "distinct_from": ["scorecard", "control-pane", "total-debt"],
      "aliases": ["repohygienescorecard"],
      "grounding": "repohygienescorecard",
      "grounding_kind": "symbol",
      "glossary_anchor": "",
      "parent": "scorecard",
      "verdict": "defined",
      "gaps": []
    },
    {
      "id": "total-debt",
      "canonical": "total_debt",
      "family": "score-debt",
      "kind": "metric",
      "definition": "The raw-unit portfolio sum of every scorecard debt integer in the control pane baseline and payload.",
      "distinction": "The RAW summed debt count - NOT grade_debt, which weights letter-grade severity, and NOT one scorecard's own *_debt integer.",
      "distinct_from": ["grade-debt", "disambiguation-debt"],
      "aliases": ["totaldebt"],
      "grounding": "totaldebt",
      "grounding_kind": "metric",
      "glossary_anchor": "",
      "parent": "control-pane",
      "verdict": "defined",
      "gaps": []
    },
    {
      "id": "grade-debt",
      "canonical": "grade_debt",
      "family": "score-debt",
      "kind": "metric",
      "definition": "The control pane's scale-invariant severity sum, mapping each scorecard's effective letter grade to A=0, B=1, C=2, D=4, F=8.",
      "distinction": "The SEVERITY-weighted grade ratchet - NOT total_debt's raw unit count and NOT a per-scorecard debt integer.",
      "distinct_from": ["total-debt", "disambiguation-debt"],
      "aliases": ["gradedebt"],
      "grounding": "gradedebt",
      "grounding_kind": "metric",
      "glossary_anchor": "",
      "parent": "control-pane",
      "verdict": "defined",
      "gaps": []
    },
    {
      "id": "concept-disambiguation-scorecard",
      "canonical": "concept-disambiguation scorecard",
      "family": "score-debt",
      "kind": "subsystem",
      "definition": "The scorecard that discovers fak's confusable concept namespace and charges disambiguation debt for unclear positioned rows plus uncovered tree tokens.",
      "distinction": "The NAMING-clarity measurement surface - NOT its disambiguation_debt output metric and NOT the control pane that folds it with other scorecards.",
      "distinct_from": ["disambiguation-debt", "control-pane", "scorecard"],
      "aliases": ["conceptdisambiguationscorecard"],
      "grounding": "conceptdisambiguationscorecard",
      "grounding_kind": "symbol",
      "glossary_anchor": "",
      "parent": "scorecard",
      "verdict": "defined",
      "gaps": []
    }
  ]
}
