Add update_docs.py and generate initial documentation

README.md

@@ -0,0 +1,91 @@
+# MTG EDH Deck Manager
+
+Command-line toolkit for managing Magic: The Gathering Commander (EDH) decks using the Scryfall API.
+
+## Installation
+
+```bash
+git clone <repo-url>
+cd Decks
+```
+
+No dependencies required - pure Python 3 standard library.
+
+## Usage
+
+### Hydrate a Collection
+
+Fetch card data from Scryfall for a decklist:
+
+```bash
+python hydrate.py hydrate collection/decklist.txt -o collection_hydrated/ -c card_cache.json
+```
+
+### Create a New Deck
+
+```bash
+python hydrate.py new my_deck
+```
+
+### Analyze Decks
+
+Find upgrade options from your collection:
+
+```bash
+python scripts/analyze_decks.py --collection collection_hydrated/deck.json --deck-dir decks/
+```
+
+### Find Synergies
+
+Search for cards by keywords, colors, and type:
+
+```bash
+# Find landfall cards in Simic colors
+python scripts/find_synergies.py --collection collection_hydrated/deck.json --colors U G --keywords landfall
+
+# Find Bird creatures in Bant colors
+python scripts/find_synergies.py --collection collection_hydrated/deck.json --colors U G W --creature-type Bird
+
+# Find instants with CMC 2 or less
+python scripts/find_synergies.py --collection collection_hydrated/deck.json --type instant --cmc-max 2
+```
+
+### Generate Reports
+
+```bash
+python scripts/deck_report.py --collection collection_hydrated/deck.json --decks-dir decks/ --output report.md
+```
+
+## Decks
+
+| Deck | Colors | Commander | Archetype |
+|------|--------|-----------|-----------|
+| Choco | UGW | Choco, Seeker of Paradise | Bird Tribal Landfall |
+| Hazel | BG | Hazel of the Rootbloom | Golgari Aristocrats |
+| Palamecia | UR | The Emperor of Palamecia // The Lord Master of Hell | Izzet Self-Mill Storm |
+| Yshtola | UBW | Y'shtola, Night's Blessed | Esper Stax Drain |
+
+## Workflow
+
+1. **Import** - Place text decklists in `collection/`
+2. **Hydrate** - Run `hydrate.py` to fetch Scryfall data → `collection_hydrated/`
+3. **Define** - Create deck JSON files in `decks/`
+4. **Analyze** - Run `analyze_decks.py` to find upgrade options
+5. **Report** - Use `deck_report.py` for markdown summaries
+
+## Collection Stats
+
+- **Total cards:** 1209
+- **Unique cards:** 866
+- **By type:**
+  - Artifacts: 84
+  - Creatures: 390
+  - Enchantments: 63
+  - Instants: 124
+  - Lands: 97
+  - Planeswalkers: 2
+  - Sorceries: 105
+
+---
+
+*This file is auto-generated. Edit `docs/templates/README.template.md` instead.*