Skip to content

Commit 61be4d7

Browse files
valvesssclaude
andcommitted
docs: refresh READMEs — Zenodo DOI, correct block range, current scope
Root README: add the minted Zenodo DOI (badge + bibtex doi field), fix the stale "blocks 00–20" range (pipeline runs all blocks), point the cite URL at the DOI. study/README: correct the run description (every block + findings.json + drift audit), and note the work now extends past the W1–P4 core through fronts B/C/E and F–U, temporal equivalence (TOST), multi-sport external validity via the canonical layer, and the /measure service — full log in docs/FINDINGS.md. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1 parent 0ed1d20 commit 61be4d7

2 files changed

Lines changed: 17 additions & 5 deletions

File tree

README.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@
1010
[![license](https://img.shields.io/badge/code-Apache--2.0-blue)](LICENSE)
1111
[![paper](https://img.shields.io/badge/paper-CC--BY--4.0-green)](study/docs/paper/draft.md)
1212
[![reproducible](https://img.shields.io/badge/pipeline-reproducible-brightgreen)](study/run.sh)
13+
[![DOI](https://img.shields.io/badge/DOI-10.5281%2Fzenodo.20822121-blue)](https://doi.org/10.5281/zenodo.20822121)
1314

1415
</div>
1516

@@ -45,7 +46,7 @@ frozen by content hash.
4546
```
4647
study/ the research — fully reproducible Python pipeline
4748
skewlib/ reusable library (de-vig, ex-ante skewness, Elo, panel, model…)
48-
analysis/ thin scripts, one per block (00–20)
49+
analysis/ thin scripts, one per block (00–51)
4950
docs/ FINDINGS (phase log), METHODOLOGY, LITERATURA, paper/ (draft)
5051
data/PROVENANCE.json frozen dataset hash + scope
5152
run.sh one command: venv + deps + fetch + all blocks
@@ -56,7 +57,7 @@ site/ the showcase frontend (Astro) — skew-dynamic.coldcodelabs.com
5657

5758
```bash
5859
cd study
59-
./run.sh # venv + deps + dataset + blocks 00→20 (figures in outputs/fig)
60+
./run.sh # venv + deps + dataset + all blocks (figures in outputs/fig)
6061
```
6162

6263
Every reported number regenerates from the frozen dataset (sha256 in
@@ -79,7 +80,8 @@ See [`CITATION.cff`](CITATION.cff), or:
7980
author = {Alves, Vitor},
8081
year = {2026},
8182
note = {Cold Code Labs},
82-
url = {https://skew-dynamic.coldcodelabs.com}
83+
doi = {10.5281/zenodo.20822121},
84+
url = {https://doi.org/10.5281/zenodo.20822121}
8385
}
8486
```
8587

study/README.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -57,8 +57,9 @@ data/PROVENANCE.json hash + window of the frozen dataset (versioned)
5757

5858
## How to run
5959

60-
Full pipeline in one command (creates venv, installs deps, fetches the data and
61-
runs blocks 00→06 in order):
60+
Full pipeline in one command (creates venv, installs deps, fetches the data,
61+
runs every analysis block in order, regenerates `findings.json`, and audits the
62+
evidence ledger for result drift):
6263

6364
```bash
6465
./run.sh # everything; --no-fetch skips the download, --no-venv uses the current python
@@ -87,5 +88,14 @@ PYTHONPATH=. python analysis/01_baseline.py # or any 0X_*
8788
| P3 derivation | ordered-probit predicts the 3rd moment from the 1st: r=+0.90, RMSE 0.024 (F5) |
8889
| P4 stable FLB | no drift in the bias (yearly corr +0.27 n.s.); year-on-year calibration intact |
8990

91+
The table above is the original core (W1–P4). The study has since extended through
92+
fronts B/C/E and F–U — shape invariance and distribution collapse, the closed-form
93+
law, price discovery (open→close), a generative-model battery, a VAR natural
94+
experiment, the pre-2005 regime, temporal **equivalence** (TOST, not just a high
95+
*p*-value), and **external validity** across three sports (football, tennis,
96+
basketball) via a sport-agnostic canonical layer (`skewlib/canonical.py` +
97+
`skewlib/adapters/`). The calibrated instrument is also exposed as a thin
98+
`/measure` service (`api/`). The full per-phase log lives in `docs/FINDINGS.md`.
99+
90100
Details and phase log in `docs/FINDINGS.md`; methodology in `docs/METHODOLOGY.md`;
91101
literature in `docs/LITERATURA.md`; paper draft in `docs/paper/draft.md`.

0 commit comments

Comments
 (0)