Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/adding-a-metric.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,4 +49,5 @@ Check a new metric against these decisions before you add it.
- Findings come from the project's own `tsc` and `eslint` when present. Otherwise srcly runs `ruff` and its own TypeScript rules. Each finding names its tool.
- Named 2x2 presets use absolute cut-offs, not cut-offs relative to the repo.
- Below the cut line: clones, coverage, CRAP, temporal coupling and trends.
- Keep or cut a metric on decision cases: read each top-ranked case in source and record a verdict. Correlation alone does not decide. `evaluate_metric_portfolio.py` reports support, N/A and zero rates, Spearman correlation and top-10 overlap per language and scope as input to that review.
- Tune defaults with evidence. The October 2026 pilot adjudicated 729 top-10 cases on four repositories, then set the defaults (for example, `comment_noise` flags 1.0 comment line per code line or more). Its method, results and open follow-ups are in `docs/research/metric-pilot-2026-10/README.md`. Rerun a pilot with `server/scripts/evaluate_metric_portfolio.py`.
16 changes: 16 additions & 0 deletions docs/initiative-history.json
Original file line number Diff line number Diff line change
Expand Up @@ -122,5 +122,21 @@
"follow_ups": [
"Dropped: a declared display-area ownership rule with area-union fixtures (m2). Nothing tracks it."
]
},
{
"title": "A metric portfolio that earns its attention",
"slug": "metric-portfolio",
"outcome": "completed",
"retired_at": "2026-11-12",
"summary": "The portfolio evaluation and catalog choice shipped inside the metric system overhaul: an evaluation script, a four-repo pilot with source-backed verdicts, and the cuts and weights it justified. Reconciled against origin/main 0bfb05ba.",
"reason": "Replaced by the metric system overhaul: #74 and #75 applied the catalog choice and #79 ran the multi-repo evaluation.",
"documentation": [
"docs/adding-a-metric.md",
"docs/research/metric-pilot-2026-10/README.md"
],
"revision": "0bfb05ba",
"follow_ups": [
"The pilot README lists its own follow-ups, including a second reviewer and a non-author repository."
]
}
]
58 changes: 0 additions & 58 deletions docs/intent/metric-portfolio/implementation-plan.md

This file was deleted.

267 changes: 0 additions & 267 deletions docs/intent/metric-portfolio/initiative-map.json

This file was deleted.

32 changes: 0 additions & 32 deletions docs/intent/metric-portfolio/intent-brief.md

This file was deleted.

Loading
Loading