Sportstime/.planning/phases/2.1-add-stadium-data-mls-wnba-nwsl-cbb/02.1-03-PLAN.md

phase, plan, type

phase	plan	type
2.1-additional-sports-stadiums	03	execute

Create NWSL sport module with complete hardcoded stadium data.

Purpose: Enable NWSL stadium data to flow through the canonicalization pipeline. Output: nwsl.py module with 13+ stadiums including capacity, year_opened, and coordinates.

<execution_context> ~/.claude/get-shit-done/workflows/execute-phase.md ~/.claude/get-shit-done/templates/summary.md </execution_context>

@.planning/PROJECT.md @.planning/ROADMAP.md @.planning/STATE.md

Prior plans in this phase:

@.planning/phases/2.1-add-stadium-data-mls-wnba-nwsl-cbb/02.1-01-SUMMARY.md @.planning/phases/2.1-add-stadium-data-mls-wnba-nwsl-cbb/02.1-02-SUMMARY.md

Pattern reference:

@Scripts/mlb.py @Scripts/mls.py (created in 02.1-01) @Scripts/wnba.py (created in 02.1-02)

Current NWSL data:

@Scripts/scrape_schedules.py (NWSL_TEAMS dict at line 126)

MLS stadiums (some shared with NWSL):

@Scripts/mls.py

Core module:

@Scripts/core.py

Tech stack available: Python 3, dataclasses, requests Established patterns: Sport module structure from mlb.py, mls.py, wnba.py Key insight: Several NWSL teams share stadiums with MLS teams - can reference mls.py hardcoded data

Task 1: Create nwsl.py module with complete stadium data Scripts/nwsl.py Create nwsl.py following the established pattern:

1. Module docstring and imports (try/except for core imports)
2. all exports list
3. NWSL_TEAMS dict (copy from scrape_schedules.py, 13 teams - verify current roster)
4. get_nwsl_team_abbrev() function
5. Hardcoded NWSL stadiums dict with COMPLETE data:

NWSL Teams and Stadiums (2025 season - 14 teams as of expansion):

• LA: Angel City FC → BMO Stadium (Los Angeles, CA) - shared with LAFC, ~22,000, opened 2018
• SJ: Bay FC → PayPal Park (San Jose, CA) - shared with SJ Earthquakes, ~18,000, opened 2015
• CHI: Chicago Red Stars → SeatGeek Stadium (Bridgeview, IL) - ~20,000 capacity, opened 2006
• HOU: Houston Dash → Shell Energy Stadium (Houston, TX) - shared with Houston Dynamo, ~22,039, opened 2012
• KC: Kansas City Current → CPKC Stadium (Kansas City, MO) - NWSL-specific, ~11,500, opened 2024
• NJ: NJ/NY Gotham FC → Red Bull Arena (Harrison, NJ) - shared with NY Red Bulls, ~25,000, opened 2010
• NC: North Carolina Courage → WakeMed Soccer Park (Cary, NC) - ~10,000, opened 2002
• ORL: Orlando Pride → Inter&Co Stadium (Orlando, FL) - shared with Orlando City SC, ~25,500, opened 2017
• POR: Portland Thorns FC → Providence Park (Portland, OR) - shared with Portland Timbers, ~25,218, opened 1926 (renovated 2019)
• SEA: Seattle Reign FC → Lumen Field (Seattle, WA) - shared with Sounders/Seahawks, ~69,000, opened 2002
• SD: San Diego Wave FC → Snapdragon Stadium (San Diego, CA) - shared, ~35,000, opened 2022
• UTA: Utah Royals FC → America First Field (Sandy, UT) - shared with Real Salt Lake, ~20,213, opened 2008
• WAS: Washington Spirit → Audi Field (Washington, DC) - shared with DC United, ~20,000, opened 2018
• BOS: Boston Breakers FC (if active - verify current NWSL roster)

Cross-reference mls.py for shared stadium coordinates and verify current league membership.

6. scrape_nwsl_stadiums_hardcoded() function returning list[Stadium]
7. scrape_nwsl_stadiums() function with fallback sources
8. NWSL_STADIUM_SOURCES configuration

Note: NWSL has had expansion and contraction - verify current team roster matches actual 2025 season. python3 -c "from Scripts.nwsl import NWSL_TEAMS, scrape_nwsl_stadiums_hardcoded; s = scrape_nwsl_stadiums_hardcoded(); print(f'{len(s)} stadiums'); print(f'{len(NWSL_TEAMS)} teams'); assert all(st.capacity > 0 for st in s); assert all(st.year_opened for st in s)" nwsl.py exists with current NWSL teams, all stadiums with non-zero capacity and year_opened values

Task 2: Integrate NWSL module and finalize phase Scripts/scrape_schedules.py Update scrape_schedules.py to use the new nwsl.py module:

1. Add import at top (with try/except pattern):

   • from nwsl import NWSL_TEAMS, get_nwsl_team_abbrev, scrape_nwsl_stadiums, NWSL_STADIUM_SOURCES

2. Remove inline NWSL_TEAMS dict (lines ~126-140) - now imported from nwsl.py

3. Update get_team_abbrev() function to use get_nwsl_team_abbrev() for NWSL

4. Update scrape_nwsl_stadiums() stub function to use the new module's implementation

5. Verify NWSL games scraping still works

6. Run full stadium update to verify all 3 new sports integrate: python3 scrape_schedules.py --stadiums-update

Do NOT remove the game scraping functions - those stay inline for now. cd Scripts && python3 -c "from scrape_schedules import NWSL_TEAMS, get_team_abbrev; print(f'NWSL teams: {len(NWSL_TEAMS)}'); abbrev = get_team_abbrev('Portland Thorns FC', 'NWSL'); print(f'Thorns abbrev: {abbrev}'); assert abbrev == 'POR'" scrape_schedules.py imports NWSL_TEAMS from nwsl.py, get_team_abbrev works for NWSL, all 3 secondary sport modules integrated

Before declaring plan complete: - [ ] nwsl.py exists with complete module structure - [ ] All NWSL stadiums have capacity > 0 and year_opened values - [ ] scrape_schedules.py imports from nwsl.py successfully - [ ] `python3 Scripts/scrape_schedules.py --stadiums-update` includes MLS, WNBA, and NWSL stadiums - [ ] No import errors when running pipeline

<success_criteria>

• nwsl.py module created following established pattern
• All NWSL stadiums with complete data (capacity, year_opened, coordinates)
• scrape_schedules.py integration works for all 3 new sports
• Phase 2.1 complete (MLS, WNBA, NWSL modules created)
• CBB deferred to future phase (documented in summary) </success_criteria>

After completion, create `.planning/phases/2.1-add-stadium-data-mls-wnba-nwsl-cbb/02.1-03-SUMMARY.md` with: - Summary of all 3 plans (MLS, WNBA, NWSL modules) - Note that CBB was deferred (350+ D1 teams requires separate scoped phase) - Phase 2.1 complete status