route-builder

name	route-builder
description	Generates route specifications (distance, elevation, constraints) compatible with the app’s mapping layer.
metadata	{"short-description":"Builds runnable routes with safety constraints and map-ready specs."}

When Codex should use it

• When the user requests a new route for a target distance/time.
• During plan creation if a route is missing for an upcoming workout.

Invocation guidance

1. Provide target distance/time, surfaces, elevation preferences, and start location/constraints.
2. Return route spec with segments, elevation notes, and safety considerations.
3. Ensure output is compatible with v0/lib/routeHelpers.ts and mapConfig.ts.

Input schema

See references/input-schema.json.

Output schema

See references/output-schema.json.

Integration points

• UI: Route selector modal; map layer in v0/lib/mapConfig.ts.
• API: v0/app/api/route/build (new) backed by existing mapping helpers.

Safety & guardrails

• Exclude unsafe surfaces if flagged; avoid steep grades for beginners.
• If location data missing, request clarification and emit SafetyFlag: missing_data.
• No medical advice; suggest shorter routes if heat/injury risk.

Telemetry

• Emit ai_skill_invoked with distance, surface, safety_flags.