# race-strategy-builder

> Generates pacing and fueling strategies for target races based on current fitness and course constraints.

- Author: nadavyigal
- Repository: nadavyigal/Running-coach-
- Version: 20260122150617
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/nadavyigal/Running-coach-
- Web: https://mule.run/skillshub/@@nadavyigal/Running-coach-~race-strategy-builder:20260122150617

---

---
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`.