plan-generator

nadavyigal's avatarfrom nadavyigal

Generates 14–21 day running plans tailored to onboarding data and recent performance.

⭐1stars🔀0forks📁View on GitHub🕐Updated Jan 3, 2026
[Lesson Planning]

When & Why to Use This Skill

This Claude skill automates the creation of personalized 14–21 day running training blocks. By analyzing user profiles, training history, and real-time telemetry, it generates data-driven plans with safe load progression, rest distribution, and detailed rationale to optimize athletic performance while minimizing injury risk.

Use Cases

  • Personalized Training Onboarding: Automatically generate a custom 3-week running plan immediately after a user completes their fitness profile and goal setting.
  • Dynamic Performance Adjustment: Update existing training calendars based on recent performance data and telemetry to ensure the difficulty level matches the user's current fitness.
  • Injury Prevention & Safety Monitoring: Use the skill's built-in safety guardrails to detect load spikes and automatically adjust plans or provide warnings when physical pain is reported.
nameplan-generator
descriptionGenerates 14–21 day running plans tailored to onboarding data and recent performance.
short-descriptionDrafts personalized training blocks with safe load progression and rationale.

When Codex should use it

  • After onboarding completion or goal updates.
  • When the user requests a new plan or calendar export.

Invocation guidance

  1. Load shared contracts from _index/references/contracts.md.
  2. Inputs must include UserProfile, TrainingHistory, and optional RecentRunTelemetry[].
  3. Enforce rest distribution and load caps from deterministic rules (v0/lib/plan-complexity-engine.ts, v0/lib/periodization.ts).
  4. Return JSON matching Plan + rationale.

Input schema (JSON)

{
  "profile": UserProfile,
  "trainingHistory": TrainingHistory,
  "startDate": "2025-01-01",
  "preferences": { "indoorOk": true, "rookieChallenge": true }
}

Output schema (JSON)

Plan & { rationale: string; safetyFlags?: SafetyFlag[] }

Integration points

  • API: v0/app/api/generate-plan/route.ts
  • Logic: v0/lib/planGenerator.ts, v0/lib/plan-templates.ts
  • UI: Today and Plan screens (Dexie data via v0/lib/db.ts)

Safety & guardrails

  • No medical diagnosis; if pain/dizziness flags are present, reduce load and advise consulting a professional.
  • Hard-cap weekly volume deltas via plan-complexity-engine.ts.
  • Emit SafetyFlag for load spikes or missing critical data.

Telemetry

  • Emit ai_skill_invoked and ai_plan_generated with plan_version, fallback_used, safety_flags.