| name | run-insights-recovery |
| description | Converts run telemetry into insights, recovery recommendations, and next-session nudges. |
| metadata | {"short-description":"Post-run insights with effort assessment, recovery tips, and safety flags."} |
When Codex should use it
- Immediately after a run is saved.
- When the user asks “how did I do?” or “what should I do next?”
Invocation guidance
- Provide
RecentRunTelemetry plus derived metrics (pace stability, splits) and upcoming workouts.
- Map effort to easy/moderate/hard and generate concise bullets.
- Return
Insight with RecoveryRecommendation and optional nextSessionNudge.
Input schema (JSON)
{
"run": RecentRunTelemetry,
"derivedMetrics": { "paceStability": string, "cadenceNote"?: string, "hrNote"?: string },
"upcomingWorkouts": Workout[],
"userFeedback"?: { "rpe"?: number, "soreness"?: string }
}
Output schema (JSON)
Insight
Integration points
- API/hooks: Post-run pipeline in
v0/lib/run-recording.ts and chat surface in v0/lib/enhanced-ai-coach.ts.
- UI: Today screen banners and run detail modal.
- Storage: Save alongside run in Dexie via
v0/lib/db.ts.
Safety & guardrails
- If HR missing, default to pace/RPE and add
SafetyFlag with missing_data.
- If user reports pain/dizziness, advise stopping and consulting a professional; downgrade next session.
- Keep guidance ≤120 words; no medical diagnosis.
Telemetry
- Emit
ai_skill_invoked and ai_insight_created with run_id, effort, safety_flags.
