principleslisted

Metric literacy for what this plugin reports: what cyclomatic complexity, cognitive complexity, Halstead difficulty, lines per file, duplication, coverage, CRAP, and type debt mean, and what none of them can tell you. Four reference files carry the definitions and what each collector computes, each bundled reference value with its provenance (why cyclomatic 20, why 22 and 80 have no citation), the CRAP formula with its name history and coverage join, and an annotated bibliography (McCabe, Halstead, NIST SP 500-235, Campbell, Lewis 2013, ISO/IEC 5055 and 25023). Cross-metric caveats live here once; owners of the measures it leaves alone are named behind a presence gate. Use when: 'what does cyclomatic complexity mean', 'is CRAP a real metric', 'why is the cyclomatic reference 20', 'what is a good coverage number', 'which metric should I look at', 'code metrics principles'; for the numbers themselves run the /code-metrics:audit-* skills.
melodic-software/claude-code-plugins · ★ 15 · AI & Automation · score 73

Install: claude install-skill melodic-software/claude-code-plugins

# 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. 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, artifact formats | [measures.md](reference/measures.md) | | Where a reference value came from, the operator's original list, 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) | 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) - **"Which measure should I look at?"**. The one attached to the change in front of you. Complexity and size are per function or per file and move with an edit; duplication and coverage are properties of the tree around it. No measure here ranks changes by risk. - **"Is 22 the cyclomatic threshold?"**. No source found in this plugin's research attributes 22 to anyone. The bundled reference is 20, from ISO/IEC 5055:2021 §8.