Files
Sportstime/.planning/ROADMAP.md
Trey t a786d7e2aa plan: Phase 8 DAG System TDD with 2 plans
- 08-01: GameDAGRouter edge cases and anchor validation TDD (17+ tests)
- 08-02: Performance with large datasets (10K+ games) and diversity coverage TDD

TDD discipline: tests define correctness, code must match.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-10 11:36:29 -06:00

4.4 KiB
Raw Blame History

Roadmap: SportsTime

Milestones

  • v1.0 Data Pipeline (Phases 1-7) — SHIPPED 2026-01-10
  • 🚧 v1.1 TDD & Correctness — Phases 8-12 (in progress)

Completed Milestones

v1.0 Data Pipeline (Phases 1-7) — SHIPPED 2026-01-10
  • Phase 1: Script Architecture (3/3 plans) — completed 2026-01-10
  • Phase 2: Stadium Foundation (2/2 plans) — completed 2026-01-10
  • Phase 2.1: Additional Sports Stadiums (3/3 plans) — completed 2026-01-10
  • Phase 3: Alias Systems (2/2 plans) — completed 2026-01-10
  • Phase 4: Canonical Linking (1/1 plans) — completed 2026-01-10
  • Phase 5: CloudKit CRUD (2/2 plans) — completed 2026-01-10
  • Phase 6: Validation Reports (1/1 plans) — completed 2026-01-10
  • Phase 7: Testing & Documentation (1/1 plans) — completed 2026-01-10

Full details: milestones/v1.0-ROADMAP.md

🚧 v1.1 TDD & Correctness (In Progress)

Milestone Goal: Test-driven validation of trip planning engine — tests define correctness, code must match

Constraints:

  • TDD approach: Write tests first with expected behavior, then fix code if tests fail (never modify tests to pass)
  • Tests must include edge cases and error conditions
  • Mix of short and long trips in test data, varied by region and mileage

Phase 8: DAG System TDD

Goal: Performance and edge case tests with tens of thousands of objects; fix code if tests fail Depends on: v1.0 milestone complete Research: Unlikely (internal patterns, existing code) Plans: 2

Plans:

  • 08-01: GameDAGRouter edge cases and anchor validation TDD
  • 08-02: GameDAGRouter performance with large datasets and diversity coverage TDD

Phase 9: Trip Planner Modes TDD

Goal: Test game scheduling (by dates), must-see games inclusion, start/end cities routing Depends on: Phase 8 Research: Unlikely (internal patterns) Plans: TBD

Test expectations:

  • By Dates: Game scheduling fits date range, no conflicts, date boundaries respect timezone
  • Must-See: All selected games appear, filler games don't conflict, impossible combos return error
  • Start/End Cities: Route begins at start city, ends at end city, games found along corridor

Plans:

  • 09-01: TBD (run /gsd:plan-phase 9 to break down)

Phase 10: Trip Builder Options TDD

Goal: Test repeat cities option (ON/OFF) and must-stops (non-game attractions) Depends on: Phase 9 Research: Unlikely (internal patterns) Plans: TBD

Test expectations:

  • Repeat Cities ON: Can visit Dallas twice for different games
  • Repeat Cities OFF: Visit each city once, algorithm picks best game
  • Must-stops: Non-game POIs (attractions) appear in itinerary

Plans:

  • 10-01: TBD (run /gsd:plan-phase 10 to break down)

Phase 11: Itinerary & Constraints TDD

Goal: Test travel itinerary output (directions, distance/time) and driving limits Depends on: Phase 10 Research: Unlikely (internal patterns) Plans: TBD

Test expectations:

  • Travel itinerary: Distance and time shown between each stop
  • Driving limits: 2 drivers × 400mi/day max = 800mi/day allowed; trips exceeding limit rejected

Plans:

  • 11-01: TBD (run /gsd:plan-phase 11 to break down)

Phase 12: Integration Validation

Goal: End-to-end scenarios and regression suite covering all planning modes Depends on: Phase 11 Research: Unlikely (internal patterns) Plans: TBD

Plans:

  • 12-01: TBD (run /gsd:plan-phase 12 to break down)

Progress

Phase Milestone Plans Complete Status Completed
1. Script Architecture v1.0 3/3 Complete 2026-01-10
2. Stadium Foundation v1.0 2/2 Complete 2026-01-10
2.1. Additional Sports Stadiums v1.0 3/3 Complete 2026-01-10
3. Alias Systems v1.0 2/2 Complete 2026-01-10
4. Canonical Linking v1.0 1/1 Complete 2026-01-10
5. CloudKit CRUD v1.0 2/2 Complete 2026-01-10
6. Validation Reports v1.0 1/1 Complete 2026-01-10
7. Testing & Documentation v1.0 1/1 Complete 2026-01-10
8. DAG System TDD v1.1 0/2 Planned -
9. Trip Planner Modes TDD v1.1 0/? Not started -
10. Trip Builder Options TDD v1.1 0/? Not started -
11. Itinerary & Constraints TDD v1.1 0/? Not started -
12. Integration Validation v1.1 0/? Not started -