docs(01-01): complete core.py + mlb.py plan

Tasks completed: 2/2
- Create core.py shared module
- Create mlb.py sport module

SUMMARY: .planning/phases/01-script-architecture/01-01-SUMMARY.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

.planning/phases/01-script-architecture/01-01-SUMMARY.md

@@ -0,0 +1,94 @@
+---
+phase: 01-script-architecture
+plan: 01
+subsystem: data-pipeline
+tags: [python, scrapers, modular-architecture, dataclasses]
+
+# Dependency graph
+requires: []
+provides:
+  - core.py shared utilities module
+  - mlb.py MLB-specific scrapers
+  - Multi-source fallback pattern for scrapers
+affects: [01-02, 01-03]
+
+# Tech tracking
+tech-stack:
+  added: []
+  patterns:
+    - "Sport-specific modules import from core.py"
+    - "ScraperSource/StadiumScraperSource for fallback configuration"
+    - "get_{sport}_team_abbrev() in each sport module"
+
+key-files:
+  created:
+    - Scripts/core.py
+    - Scripts/mlb.py
+  modified: []
+
+key-decisions:
+  - "Each sport module has its own get_team_abbrev function for independence"
+  - "Import fallback pattern (try/except) for running from Scripts/ or project root"
+
+patterns-established:
+  - "core.py exports shared utilities via __all__"
+  - "Sport modules import from core, define team mappings, scrapers, source configs"
+
+issues-created: []
+
+# Metrics
+duration: 5min
+completed: 2026-01-10
+---
+
+# Phase 1 Plan 01: Core + MLB Modules Summary
+
+**Created core.py shared utilities and mlb.py as the first sport module, establishing the modular pattern for subsequent sports**
+
+## Performance
+
+- **Duration:** 5 min
+- **Started:** 2026-01-10T05:53:50Z
+- **Completed:** 2026-01-10T05:59:10Z
+- **Tasks:** 2
+- **Files modified:** 2
+
+## Accomplishments
+
+- Created `Scripts/core.py` with all shared utilities (rate limiting, dataclasses, fallback system, export)
+- Created `Scripts/mlb.py` with MLB_TEAMS, 3 game scrapers, 3 stadium scrapers, and source configs
+- Established modular pattern that NBA, NHL, NFL will follow
+
+## Task Commits
+
+Each task was committed atomically:
+
+1. **Task 1: Create core.py shared module** - `edbb5db` (feat)
+2. **Task 2: Create mlb.py sport module** - `cdf4c77` (feat)
+
+## Files Created/Modified
+
+- `Scripts/core.py` - Shared utilities: rate limiting, Game/Stadium dataclasses, fallback system, ID generation, export
+- `Scripts/mlb.py` - MLB team mappings, Baseball-Reference/Stats API/ESPN scrapers, stadium scrapers, source configs
+
+## Decisions Made
+
+- Each sport module defines its own `get_{sport}_team_abbrev()` function rather than a shared one — keeps modules independent
+- Used try/except import pattern to support both direct execution (`python mlb.py`) and import from project root
+
+## Deviations from Plan
+
+None - plan executed exactly as written.
+
+## Issues Encountered
+
+None
+
+## Next Phase Readiness
+
+- core.py and mlb.py pattern established
+- Ready for 01-02-PLAN.md (nba.py + nhl.py modules)
+
+---
+*Phase: 01-script-architecture*
+*Completed: 2026-01-10*