Guides
How the loop works
One coach loop — train, fuel, recover, race. The science engine decides the numbers; constrained AI explains them. Life rewrites the week inside the same inspectable system.
North star
Engine decides. AI explains.
Koyaro is an explainable whole-athlete OS with a cycling wedge. A deterministic sports-science engine owns fitness, fatigue, form, fueling bands, readiness, and load projections. The conversational layer narrates those outputs — it is not allowed to invent watts, readiness scores, or fueling targets.
That split is the product bet. Chat is not the coach. The coach is the loop you can interrogate: what today asks for, why the week looks like this, and how fuel and recovery sit beside the calendar.
The loop
Train → fuel → recover → race
Competitors often leave nutrition and readiness as bolt-ons. Koyaro keeps them in one coach loop so the prescription reflects the athlete you are today — not only last week's ride file.
- Today — the daily call combines sessions, wellness, meals, and readiness. Ask why; answers cite engine signals, not vibes.
- Adaptive week — the living calendar holds load, rest, and compliance. Missed work or a short window rewrites the plan without abandoning the projection.
- Fueling / Body — carbohydrate targets and energy-awareness sit beside power data so hard days are fueled and protected days stay honest.
- Race week — countdown, tactics, and limiter-aware prep stay in the same brain that builds training days — not a separate spreadsheet.
The product tour on how it works walks import → model → daily call → adaptation. This guide is the thesis: one loop, not four apps stitched with chat.
When life happens
The week rewrites — and stays interrogable
Missed sessions, low readiness, illness flags, or a forty-minute window do not break the system. They change the week. Projections move with compliance and recovery signals — and you can still ask why a hard day disappeared or an easy day took its place.
Adaptation without inspectability is just another black box. Koyaro keeps the rewrite inside the same engine you can cite — the standard we spell out in show your work.
Honest scope
What this loop is not claiming
Cycling-first, coach-desk honest. Cycling remains the wedge. Run and swim sit in the same coach loop — sport-aware Run-load / Swim-load and per-sport Form on Today and the calendar, in one shell (Banister Form when the session is run or swim; bike Form stays Coggan TSB). That is coach-desk honesty, not a triathlon-coach rebrand. We still do not claim a triathlon coach, Ironman prep, or a race-week triathlon planner.
Not chat-first. Fluency is not physiology. The LLM helps you act on engine numbers; it does not invent metrics or replace the science core.
Not “Intervals + ChatGPT.” intervals.icu is a friend and ingest path. Analytics depth is not the same product as a living, whole-athlete coach loop.
One loop. Show the work.
Join the waitlist for closed beta. When you’re invited, interrogate the first daily call — that is the demo.