principleslisted

# Code metrics knowledge base The five `audit-*` skills in this plugin print numbers with their provenance and stop. This skill says what each number means, where its reference value came from, and where reading it as a verdict goes wrong. It renders no verdict of its own, and neither does the plugin: a reference is a value to count against, never a bar, and no skill here emits a finding, a severity, or an exit-code gate, because a finding needs a measured corpus sweep behind it and none has been run. Reference files in `reference/` are source-attributed; the sections below answer the common questions without a load. ## Routing table | Query about... | Load | |---|---| | What a measure is, its formula, per-lane collector behavior, coverage artifact formats | [measures.md](reference/measures.md) | | Where a reference value came from, which popular numbers have no source, how to set your own | [thresholds.md](reference/thresholds.md) | | The CRAP formula, its two authorial names, the coverage join, what it does not predict | [crap.md](reference/crap.md) | | Who published what, what a paper claims and does not claim, confidence per source | [literature.md](reference/literature.md) | | The report vocabulary (`cov_source`, `not-applicable`, `partial`) and the JSON document shape | `${CLAUDE_PLUGIN_ROOT}/reference/report-schema.md` | Load the one file the question lands in. Load a second only when the first leaves the question open. ## Quick decision guide (no file load needed