matchupland #

NFL + FBS college football matchup cards, team/player charts, and (eventually) live game pages. It's a self-hosted personal project.

• Plan: docs/ARCHITECTURE_PLAN.md (start with §0, Owner decisions)
• Agent rules: CLAUDE.md
• Phase notes: docs/phases/

Layout #

• pipeline/: Python package matchupland (uv). It covers ingestion, the canonical model, metrics, ranking, views and the API.
• config/: league rules, card/view definitions, adjustments and schedules. This is data, not code.
• scripts/ci.sh: the full CI run. It works the same locally and in the Tangled spindle (.tangled/workflows/ci.yml).
• deploy/: Docker Compose (placeholders until Phase 4–5).

Run #

bash scripts/ci.sh
cd pipeline && uv run mland config

Data (data/), secrets (deploy/.env) and downloaded logos are never committed.