euroleague-analytics: Instructions file for Claude Code

CLAUDE.md

euroleague-analytics CLAUDE.md is an instructions file for Claude Code from egemeny13/euroleague-analytics. It costs 5,924 tokens per session, scanned A, original, MIT.

Project instructions for EuroLeague Analytics, a data warehouse that derives basketball statistics from public play-by-play data and makes them available to language models through an MCP server.

In plain words
What is it for?
Use them before changing the project's data processing, possession counts, four-factor statistics, lineup on/off metrics, tests, documentation, or MCP interface.
Why use it?
They tell an agent what the project is for, what is out of scope, how to validate changes, and how to communicate technical details to a non-programmer owner.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md. Also seen: reads .claude/ paths; mentions CLAUDE.md; mentions AGENTS.md.

This is egemeny13/euroleague-analytics's own configuration. It tells Claude Code how to work on euroleague-analytics itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything euroleague-analytics configures →

Reuse

Borrowing it

Nothing to install: this file belongs to egemeny13/euroleague-analytics. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/egemeny13/euroleague-analytics/master/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/egemeny13/euroleague-analytics

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for euroleague-analytics CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/egemeny13/euroleague-analytics/claude-md/github.svg)](https://agentmods.dev/instructions/egemeny13/euroleague-analytics/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/egemeny13/euroleague-analytics/claude-md"><img src="https://agentmods.dev/badge/instructions/egemeny13/euroleague-analytics/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for euroleague-analytics CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/egemeny13/euroleague-analytics/claude-md"><img src="https://agentmods.dev/badge/instructions/egemeny13/euroleague-analytics/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 5,924 This file is loaded in full into every session.
When invoked 5,924 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.05924 $0.05924
Opus 5 $0.02962 $0.02962
Sonnet 5 $0.01185 $0.01185
Haiku 4.5 $0.00592 $0.00592

Measured 3d ago against content hash 5c7b198e941f, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

euroleague-analytics CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 416 lines

How it starts

The opening of the file, as written. The whole thing — 416 lines — stays where its author put it; the contents beside it link to each section on GitHub.

EuroLeague Analytics

Project goal

A validated data warehouse for EuroLeague and EuroCup basketball, built from the public play-by-play API, exposed to LLMs through an MCP server.

This is not an API wrapper. Thin wrappers already exist and are worthless. The value of this project lives entirely in the derived layer: exact possession counts, four factors, and lineup-level on/off metrics reconstructed from play-by-play events. If a feature does not contribute to that layer, it is out of scope.

About the owner

I direct this project, but I cannot read Python or SQL. I will not catch a logic error by reading your code. Therefore:

  • After writing any non-trivial function, explain it line by line in plain language, assuming I do not know pandas or SQL.
  • Never rely on me to spot a bug. Rely on tests.
  • Prefer boring, obvious code over clever code. Readability beats elegance.
  • When you make a design decision with a real trade-off, stop and explain the trade-off in plain language before proceeding.

Language

All code, comments, variable names, commit messages, documentation, MCP tool descriptions, and test names must be in English. No exceptions.


The project documents, and which one wins

This file holds the rules. It is not the whole context, and it is not the most recent word on every subject. Read these before starting work:

File What it holds Authority
CLAUDE.md (this file) The rules Binding. Override only with a measurement and a decision.
CONTEXT.md Why the project exists, who it is for, the constraints Binding on goals, not on technique. Untracked by git and local to the owner's machine — see DECISIONS.md item 13. If it is not present, you are working from a clone and should ask for the goals rather than infer them.
DECISIONS.md Settled technical decisions and their conditions Binding, and newer than this file. A condition attached to a decision is part of the decision.
ROADMAP.md Phase sequence and the gate that opens each phase Binding on sequence.
exploration/FINDINGS.md Single-game API reconnaissance Evidence, not rules.
exploration/SEASON_SWEEP.md Full-season validation, 330 games Evidence. The numbers here are the regression baseline.
exploration/SCHEMA_PROPOSAL.md The approved schema Approved as amended by DECISIONS.md. Where the two disagree, DECISIONS.md wins — it is later.
exploration/OPEN_ITEMS.md Phase 1 measurements behind decisions 7 and 8 Evidence, with its estimate boundaries stated explicitly. Do not quote its extrapolations as measurements.

Read the full file on GitHub · 416 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago Changed · +3 lines · +56 tokens per session 5c7b198e941f
  2. 6d ago Changed · +47 lines · +786 tokens per session c3f647f48261
  3. 9d ago First seen · 366 lines · 5,082 tokens per session scan A 646a75688b5f

Subscribe to this mod's changes

euroleague-analytics CLAUDE.md is an instructions file published in the GitHub repository egemeny13/euroleague-analytics (0 stars, last pushed 2d ago), licensed MIT. It adds 5,924 tokens to every session, about $0.0296 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other instructions, from other repositories

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,296 tokens

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,153 tokens

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 6,785 tokens

spec-kit AGENTS.md

AGENTS.md instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.

github/spec-kit · 7,104 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).

microsoft/vscode · 5,001 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,469 tokens