An MTG card interaction graph — a build-time pipeline that ingests one Standard set from Scryfall and emits a JSON artifact, plus a React + Vite web app that browses it, surfaces card interactions, and builds decks. No backend.

git clone <this-repo>
cd mtg-graph
npm install
cd app && npm install && cd ..

npm run build:cards -- --set <SET_CODE>
# e.g. npm run build:cards -- --set tdm

This writes app/public/data/cards-<SET_CODE>.json. Set the corresponding env var in app/.env.local:

VITE_SET_CODE=tdm

cd app
npm run dev

Open http://localhost:5173.

• Pipeline + shared types: npm test (from repo root)
• Web app units + components: cd app && npm test
• Web app e2e smoke: cd app && npm run e2e

• pipeline/ — Node + TS data pipeline. Fetches Scryfall, normalizes oracle text, applies regex rules, builds the interaction graph, emits a JSON artifact.
• shared/ — Types shared by pipeline and web app (Card, Edge, TagDef, Artifact).
• app/ — React + TS + Vite SPA. Loads the artifact, hydrates an in-memory graph, serves browsing, filtering, interactions, and deck building.

• v0.2 — Nova Lite verification of regex tags, tag-inspection admin view, deck text import.
• v0.3 — Multi-card synergy ranking.
• v0.4 — More sets (Standard → Modern → Pioneer).
• v0.5+ — Backend with shared decks and community tags.

The repo ships with a pair of Claude Code skills (mtg-graph-card-tag-audit and mtg-graph-narrow-tag-rule) for stress-testing tag accuracy against real card text and shipping the resulting rule fixes. A typical batch-audit prompt looks like:

Audit the next 400 cards in parallel mode with 3 agents. Synthesize consensus, ship the high-confidence fix batches via mtg-graph-narrow-tag-rule, and run a full-diff verifier before commit.

Run that from a Claude Code session at the repo root. The audit skill reads cards off UNPROCESSED_CARDS.txt, logs findings to CARD_ISSUES.md, and the narrow-rule skill turns those findings into regex tightenings.