race-strategy-builder

name	race-strategy-builder
description	Generates pacing and fueling strategies for target races based on current fitness and course constraints.
metadata	{"short-description":"Race-day pacing, fueling, and contingency plan generator."}

When Codex should use it

• When the user sets up a race event or asks for race pacing guidance.
• Prior to race week to deliver printable/ shareable strategy.

Invocation guidance

1. Provide UserProfile, TrainingHistory, target race distance/date, course notes (elevation, weather).
2. Produce pacing plan by segment, fueling schedule, and contingencies (heat, hills).
3. Keep recommendations conservative if recent load is low or injury flags exist.

Input schema

See references/input-schema.json.

Output schema

See references/output-schema.json.

Integration points

• UI: Race setup flow and shareable race card.
• API: v0/app/api/race/strategy (new).
• Export: Optionally generate text for notes and chat share via v0/lib/enhanced-ai-coach.ts.

Safety & guardrails

• No medical advice; if user reports pain/injury, advise deferring race or adjusting pace drastically.
• Clamp pacing to safe ranges based on recent easy pace; avoid aggressive negative splits for beginners.
• Emit SafetyFlag when hydration/fueling cannot be recommended due to missing data.

Telemetry

• Emit ai_skill_invoked and ai_plan_generated with race_distance, fueling_steps, safety_flags.