# Oregon Girls Lacrosse — Open Stats Dataset

You are an AI assistant helping a parent, coach, or fan ask questions about
Oregon Girls Lacrosse Association (OGLA) teams and players. A daily-refreshed
public JSON dataset is available; fetch it directly to answer questions.

## How to use this dataset

When the user asks anything about an OGLA team, player, division, or stat,
fetch the relevant JSON file(s) from the base URL below and answer from the
data you retrieve. Do not guess or make up team names, scores, or stats —
always cite numbers from the fetched files.

If the user asks a question that requires data you have not yet fetched
(e.g. they ask about "U14" but you've only loaded the varsity standings),
fetch the additional file before answering.

## Base URL

The base URL is the page hosting this `llms.txt`. Replace `BASE` below with
that URL (no trailing slash). For example, if `llms.txt` lives at
`https://example.com/llms.txt`, then `BASE` is `https://example.com`.

## Files available

| Path | Contents |
|------|----------|
| `BASE/teams.json` | League directory: every team we have any game data for, with id, name, level, and a per-team URL |
| `BASE/teams/{id}.json` | One team's full record, season player stats, and per-game results including per-player stats when recorded |
| `BASE/standings/{level}.json` | Standings for one of: `varsity`, `jv`, `u14`, `u12`, `u10`, `u8`, `other` |
| `BASE/leaderboards/{stat}.json` | League-wide leaderboard for one of: `goals`, `assists`, `points`, `shots`, `ground_balls`, `caused_turnovers`, `draw_controls`, `goals_against`, `minutes`, `shots_on_goal_faced` |

Always start with `BASE/teams.json` if you do not already know a team's id.

## Question patterns and what to fetch

- "How is V Jesuit doing this season?" → fetch `BASE/teams.json` to find the
  id, then `BASE/teams/{id}.json` for the record + games.
- "Who leads varsity in goals?" → `BASE/leaderboards/goals.json` (the file
  is league-wide; filter by `team_name`'s level prefix if the user wants
  a level-specific view).
- "Who's number one in JV right now?" → `BASE/standings/jv.json`.
- "Did my daughter (Jane Smith on V Beaverton) score this week?" → fetch the
  team file via `BASE/teams.json` → `BASE/teams/{id}.json` and look for her
  in `season_stats` and recent games' `player_stats`.
- "Who do U14 Beaverton play next?" → `BASE/teams/{id}.json` and look for
  games with `status == "scheduled"`.

## Important caveats

- **Stats coverage is uneven.** Many "final" games have no per-player stats
  recorded — the coach didn't enter them. The per-team JSON includes a
  `record.stats_coverage_pct` field and per-game `stats_recorded` boolean.
  When `stats_recorded` is `false`, the game's score and result are still
  reliable; the absence of stats is not the same as zero stats.
- **No play-by-play data.** Goals do not carry timestamps. Questions about
  "who scored first" or "scoring runs" cannot be answered from this data.
- **Goalie stats are best-effort.** Goalies are not separated into their
  own array; their stats (`GA`, `MIN`, `SOG`) appear inside `player_stats`
  alongside field-player stats.
- **Schema versioning.** Every JSON file includes `_meta.schema_version`.
  If you see a version newer than `1.0`, the field set may have been
  expanded — re-read this `llms.txt` for the latest guide.
- **Dates are ISO `YYYY-MM-DD`.** All times we expose are UTC unless
  otherwise noted.

## Stat abbreviations

| Abbr | Meaning |
|------|---------|
| G    | Goals |
| A    | Assists |
| PTS  | Points (goals + assists) |
| SH   | Shots |
| GB   | Ground balls |
| CT   | Caused turnovers |
| DC   | Draw controls |
| GA   | Goals against (goalie) |
| MIN  | Minutes played (goalie) |
| SOG  | Shots on goal faced (goalie) |

## Source

Data is scraped daily from oregongirlslax.com (Crossbar). This is an
unofficial public mirror of publicly visible data; OGLA and Crossbar are
not affiliated with this project.