withqwerty/nutmeg/store

Store

Help the user choose storage formats, locations, and publishing methods for their football data.

Accuracy

Read and follow ${CLAUDE_PLUGIN_ROOT}/docs/accuracy-guardrail.md before answering any question about provider-specific facts (IDs, endpoints, schemas, coordinates, rate limits). Always use search_docs — never guess from training data.

First: check profile

Read .nutmeg.user.md. If it doesn't exist, continue with sensible defaults (Python and pandas, intermediate level) and suggest running /nutmeg setup at the end.

Storage format decision tree

Small projects (< 100MB, single user)

Recommendation: Start with JSON for raw data, Parquet for processed data.

Medium projects (100MB - 10GB)

Recommendation: Parquet for storage, DuckDB for querying.

Large projects (> 10GB, multiple users)

Prices and free tiers change. Check the provider's current pricing page before you quote a number.

Directory structure

Recommend this structure for football data projects:

project/
  data/
    raw/                  # Untouched API/scrape responses
      statsbomb/
        events/
        matches.json
      fbref/
        2024/
    processed/            # Cleaned, transformed data
      events.parquet
      shots.parquet
      passes.parquet
    derived/              # Computed metrics
      xg_model.parquet
      passing_networks/
  notebooks/              # Analysis notebooks
  scripts/                # Data pipeline scripts
  outputs/                # Charts, reports, exports
  .env                    # API keys (gitignored)
  .nutmeg.user.md         # Nutmeg profile

Publishing and sharing

Interactive dashboards

Static sites

Sharing data

Handing over a research project

In a research project (research/.active exists), package the work for a teammate, a reviewer or a client with python3 "${CLAUDE_PLUGIN_ROOT}/core/nutmeg.py" bundle --raw no (or --raw yes). Always ask the user which, every time:

• --raw no keeps raw data (the project's data/, run outputs and figure snapshots) out and lists it by hash.

Safe for licensed provider or club data.

• --raw yes includes it. Only when the user has the right to share the data; the gate shows the team's licence notes.

The bundle always holds the question, plan, ledger, receipts, outputs, run records with their code, the data manifest and the environment (lockfiles, or the Python version and package list).

Social media / content

Cost awareness

Based on the user's .nutmeg.user.md goals, flag costs:

• Exploration/learning: Everything can be free. StatsBomb open data + Jupyter/Colab + GitHub Pages.
• Content creation: Streamlit Community Cloud is free. Cloudflare Pages is free.
• Professional: Budget for commercial data access. Provider pricing is negotiated, so do not quote a figure.
• Product: Database hosting ($7-50/mo), consider data licensing costs separately.