---
name: build-training-plan
description: "Generates a complete macrocycle (base/build/peak/taper) from a runner's goal, target race date, available training days, and current VDOT. Writes plan.json. Use during /run-init and /run-replan."
---

# Build Training Plan

Constructs a full periodized training macrocycle from the user's race goal, target date, current VDOT, and lifestyle constraints. Produces a week-by-week plan with daily workout prescriptions drawn from `data/workout-templates.json`, enforcing the 3-up-1-down volume progression and polarized methodology. The final 2-3 taper weeks are shaped by the `taper-protocol` skill.

## When to use

- The user completes `/run-init` and all profile fields are populated in `storage/users.json`.
- The user runs `/run-replan` (race date change, injury recovery, or schedule reset).
- A VDOT bump from `adapt-plan` makes paces stale enough to warrant regenerating the remainder of the plan.

## Outputs

A fully populated `storage/plan.json` with phases, weekly prescriptions, and day-level workout cards. The file is written atomically and then validated by the `plan-integrity-check` hook.

See `body.md` for full instructions and `scripts/macrocycle.py` for the date-math and phase-split logic.