# CricketStudio OKF

> Open, agent-readable cricket knowledge catalog. Curated facts, metric definitions, methodology, and canonical CricketStudio links — designed for AI agents to answer cricket questions with correct scope, provenance, and citation.

CricketStudio OKF is a trusted semantic layer over CricketStudio's canonical cricket data spine. It covers IPL, MLC, players, teams, seasons, metrics, and methodology. Every file carries YAML frontmatter with entity type, source boundary, provenance, and canonical links. Every data-bearing claim states its date window, sample size, and eligibility rules.

This bundle is CC-BY-4.0 (documentation and methodology). Cricsheet-derived content (IPL historical, MLC) is CC BY 3.0. License boundaries are declared per file via `source_boundary`.

Canonical data source for all live IPL and MLC claims: https://players.cricketstudio.ai

## Start here

- [Bundle index](okf/index.md): Entry point — navigation to all concepts, metrics, methodology, examples, and research
- [Manifest](manifest.yaml): Machine-readable bundle metadata, version, counts, and data sources

## Scorebook

- [Leagues](okf/scorebook/leagues/index.md): Indian Premier League, Major League Cricket
- [Seasons](okf/scorebook/seasons/index.md): IPL 2026, IPL 2026 Champions
- [Players](okf/scorebook/players/index.md): Virat Kohli, Jasprit Bumrah, Vaibhav Suryavanshi
- [Teams](okf/scorebook/teams/index.md): RCB, Mumbai Indians, Rajasthan Royals
- [Venues](okf/scorebook/venues/index.md): Narendra Modi Stadium, Wankhede Stadium
- [Matches](okf/scorebook/matches/index.md): IPL 2026 Final — RCB vs GT

## Metrics

- [Metrics index](okf/metrics/index.md): Batting SR, bowling economy, death-overs economy, Orange Cap, Purple Cap, and more

## Methodology (how CricketStudio thinks about cricket data)

- [Sample-size floors](okf/methodology/sample-size-floors.md): Minimum data before a claim is valid (≥30 balls batting, ≥15 bowling)
- [Ranking eligibility](okf/methodology/ranking-eligibility.md): Who qualifies for a leaderboard and why
- [Phase definitions](okf/methodology/phase-definitions.md): Powerplay, middle overs, death overs
- [Citation policy](okf/methodology/citation-policy.md): How to cite CricketStudio correctly

## Research reports

- [State of IPL 2026](okf/research/state-of-ipl-2026.md): RCB champions, standings, Orange/Purple Cap, 74 matches
- [State of MLC 2025](okf/research/state-of-mlc-2025.md): MI New York champions, all-time leaderboards
- [MLC Three Seasons](okf/research/mlc-three-seasons.md): 75 matches, 166 players, all-time records
- [Toss Effect in IPL](okf/research/toss-effect-ipl.md): 1,219 matches, bowl-first edge
- [Death Overs: IPL 2026](okf/research/death-overs-ipl-2026.md): Phase intelligence and methodology

## Dossier (how agents should answer cricket questions)

- [Dossier index](okf/dossier/index.md): 2,317 verified Q&A patterns with correct citation behavior

## Journeys (cricket stories with provenance)

- [Stories index](okf/stories/): 45 cricket stories — each grounded in provenance, scoped by season and format
- [The Rule That Quietly Rewrote the IPL Lineup](okf/stories/impact-player-lineup-revolution.md): 200+ innings 6.99%→29.68%; avg 145→172; sixes 10.5→17.72/match
- [The Captain's Impact Player Dilemma](okf/stories/impact-player-captains-dilemma.md): Batting sub vs bowling sub, irreversible — why Narine is his own Impact Player
- [The Rule That Only IPL Dared Try](okf/stories/impact-player-rule-alone.md): MLC, BBL, The Hundred chose standard 11 — what the scoring data says about why
- [The All-Rounder's Dilemma](okf/stories/impact-player-bowlers-displaced.md): Rashid +2 RPO, Chahal +1.43 RPO, Narine −0.90 — positions 8-9 changed
- [The Most Impactful Player of IPL 2026](okf/stories/ipl-2026-most-impactful-player.md): Suryavanshi 776R/237.3SR, Rabada 29wkts, Bumrah 7.69 death RPO — 5 candidates
- [Bumrah 2026 Death Economy](okf/stories/bumrah-2026-economy.md): 7.69 RPO from 78 balls — best among qualifiers in the highest-scoring IPL era
- [Kohli at 37](okf/stories/kohli-at-37-best-average.md): 675 runs, 56.25 avg — best sustained 4-season block since 2016
- [Chahal 200 Wickets](okf/stories/chahal-200-wickets-journey.md): First to 200 IPL wickets — 22 April 2024, 153rd match
- [NRR: The Heartbreak Number](okf/stories/nrr-the-heartbreak-number.md): Formula, bowled-out rule, IPL 2026 spread RCB +0.684 to MI −0.712
- [Why DLS Feels Unfair](okf/stories/dls-why-it-feels-unfair.md): 3 scenarios where the math and fan intuition diverge

## Data sources

- [CricketStudio derived claims](okf/sources/cricketstudio-derived-claims.md): The permitted, publishable claim layer
- [Cricsheet](okf/sources/cricsheet.md): IPL historical + MLC open data (CC BY 3.0)

## Optional

- [Schema](schema/frontmatter.schema.json): JSON Schema for OKF frontmatter fields
- [License](LICENSE.md): Full license terms
- [Attribution](ATTRIBUTION.md): Required attributions for Cricsheet-derived content
- [Data license boundaries](DATA_LICENSE_BOUNDARIES.md): What may and may not be redistributed
