Deck Organization

🚨 4-LEVEL FOLDER STRUCTURE: All scripts MUST support both:

• New: decks/<format>/<deck-name>/<variant>/<file>.mtg (4 levels)
• Legacy: decks/<format>/<deck-name>/<file>.mtg (3 levels)
• Cache mirrors: cache/decks/<format>/<deck-name>/<variant>/<file>-cache.json

When running analysis tools, use the FULL path including variant folder:

• ✅ npm run analyze decks/commander/blood-rites/20251202-1051-optimized/20251202-1051-optimized.mtg
• ❌ npm run analyze decks/commander/blood-rites/20251202-1051-optimized.mtg

Current Deck Tracking

• decks/<format>/<deck-name>/CURRENT - Text file containing the active variant name
• npm run current <deck-name> - See which variant is currently built
• ALWAYS create a CURRENT file when user indicates a deck is actually built
• Example content: 20251207-0742-indulgent-aristocrat

Creating New Variants

# Generate timestamped folder name
npm run timestamp -- -d "optimized"
# Output: 20251202-1430-optimized

# Create folder and deck file
mkdir -p decks/commander/<deck-name>/20251202-1430-optimized

# Generate analyzed and moxfield files
npm run dev decks/commander/<deck-name>/20251202-1430-optimized/20251202-1430-optimized.mtg
npm run export decks/commander/<deck-name>/20251202-1430-optimized/20251202-1430-optimized.mtg

Analyzed File Format (.analyzed.mtg)

The analyzed file includes:

• Complete card list organized by type
• Mana curve distribution (0-7+ CMC with counts)
• Card type breakdown with percentages
• Color distribution
• Average CMC (non-land)
• Total and unique card counts
• CRITICAL: After npm run count, update category totals in headers to match

Reorganizing by Functional Categories

After generating .analyzed.mtg, reorganize cards by function:

Standard Categories:

• Commander (1), Ramp, Draw, Removal, Board Wipes, Tutors, Protection, Recursion, Win Conditions, Synergy/Strategy, Utility, Lands

IMPORTANT: Cards can appear in multiple categories (e.g., Village Rites = Draw + Sacrifice Outlet)

How to reorganize:

1. Open .analyzed.mtg after generation
2. Read oracle text from cache to categorize cards
3. List cards in ALL relevant categories
4. Update category counts in headers

Deck Analysis Sections

After reorganizing, add comprehensive analysis:

• Bracket: Power level 1-5 (run npm run bracket <deck-file>)
• Description: 3-5 sentence strategy overview
• Play Patterns: Early/mid/late game plans
• Common Sequencing: Example turn sequences
• Weaknesses: What the deck struggles against
• Upgrade Paths: Specific improvement suggestions (with real prices from npm run price-cards)
• Top 10 Best Cards: Most impactful cards with one-sentence explanations
• Bottom 10 Weakest Cards: Least impactful with explanations

Card listing format (enables mtg-code hover):

1 Necropotence
Provides massive card advantage at minimal life cost

Legacy Files (pre-December 2025)

• moxfield.txt - Original imported decklist
• organized.txt - Deck organized by card function
• Root-level timestamped files (e.g., 20251201-2054-updated-list.mtg)

Known Deck URLs

For updating decks from Moxfield:

• blood-rites: https://www.moxfield.com/decks/DebJHvH3Uku9JZqBOpBvOg
• tricky-terrain: https://www.moxfield.com/decks/gmj06aiKMEaNLgGOD1ooUg

npm run import https://www.moxfield.com/decks/<id> <deck-name> --force