farhoodlabs/cycling-training
8
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases 1 Wiki Activity

Add road-racing and TT demand docs (balance the MTB doc) #3

Open
Chris Farhood wants to merge 2 commits from feat/road-tt-demands into main
pull from: feat/road-tt-demands
merge into: farhoodlabs:main
Conversation 0 Commits 2 Files Changed 10
+309 -10
Chris Farhood commented 2026-07-21 01:05:35 +00:00
Owner
Copy Link
Copy Source

Closes the asymmetry flagged in review: the skill had mtb-xco-demands.md but road/TT demands were only diffused through the general docs, despite the balanced MTB+road scope. Adds two dedicated, self-contained demand profiles.

Kept separate (not one combined doc) because mass-start racing and TT differ as much as XCO differs from marathon MTB — lumping them would repeat the "don't over-transfer" mistake the skill warns against.

New docs

  • references/road-racing-demands.md — stochastic/intermittent power profile (Vogt 2007; Ebert 2005/2006; Sanders & van Erp 2021), drafting economics — bunch drag ~5–10% of isolated (Blocken 2018), the fatigued finishing sprint (Menaspà 2013/2015; Etxebarria 2019), durability as a success determinant (van Erp/Sanders/Lamberts 2021). Power governs, HR unreliable — mirrors the MTB doc. Criterium-vs-road gap flagged.
  • references/tt-demands.md — aerodynamic drag dominance + CdA as the top lever (Crouch 2017; Martin 1998; García-López 2008), critical power as the predictor (Smith 1999), even-vs-variable pacing (Swain 1997; Atkinson 2007), long-TT durability (Maunder 2021). HR more usable than MTB (steady state) but still secondary.

Citations

All new quantitative claims carry verified PMIDs/DOIs (verified via PubMed/CrossRef by two verification agents). citations.md gains Road-racing and Time-trial sections. Honesty flags preserved:

  • Blocken 2018 and Martin 1998 have no PMID — cite by DOI (journals not MEDLINE-indexed).
  • The "~90% aero at 40 km/h" soundbite (Kyle & Burke 1984) is a trade-magazine claim, unverifiable — marked approximate, verifiable anchors substituted.
  • No unverified HR-reliability citation added — TT HR guidance defers to data-confounds.md.

Wiring

  • SKILL.md router + README layout updated with both docs.
  • Verified: build-skill-zip.sh auto-includes both (17 files now); all internal doc links resolve.

🤖 Generated with Claude Code

https://claude.ai/code/session_01TqrhBhC3GEcKyaw8RTk8G6

Closes the asymmetry flagged in review: the skill had `mtb-xco-demands.md` but road/TT demands were only **diffused** through the general docs, despite the balanced MTB+road scope. Adds two dedicated, self-contained demand profiles. Kept **separate** (not one combined doc) because mass-start racing and TT differ as much as XCO differs from marathon MTB — lumping them would repeat the "don't over-transfer" mistake the skill warns against. ## New docs - **`references/road-racing-demands.md`** — stochastic/intermittent power profile (Vogt 2007; Ebert 2005/2006; Sanders & van Erp 2021), drafting economics — bunch drag ~5–10% of isolated (Blocken 2018), the fatigued finishing sprint (Menaspà 2013/2015; Etxebarria 2019), durability as a success determinant (van Erp/Sanders/Lamberts 2021). Power governs, HR unreliable — mirrors the MTB doc. Criterium-vs-road gap flagged. - **`references/tt-demands.md`** — aerodynamic drag dominance + CdA as the top lever (Crouch 2017; Martin 1998; García-López 2008), critical power as the predictor (Smith 1999), even-vs-variable pacing (Swain 1997; Atkinson 2007), long-TT durability (Maunder 2021). HR more usable than MTB (steady state) but still secondary. ## Citations All new quantitative claims carry **verified PMIDs/DOIs** (verified via PubMed/CrossRef by two verification agents). `citations.md` gains Road-racing and Time-trial sections. Honesty flags preserved: - **Blocken 2018 and Martin 1998 have no PMID** — cite by DOI (journals not MEDLINE-indexed). - The "~90% aero at 40 km/h" soundbite (Kyle & Burke 1984) is a trade-magazine claim, **unverifiable** — marked approximate, verifiable anchors substituted. - **No unverified HR-reliability citation added** — TT HR guidance defers to `data-confounds.md`. ## Wiring - SKILL.md router + README layout updated with both docs. - Verified: `build-skill-zip.sh` auto-includes both (17 files now); all internal doc links resolve. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01TqrhBhC3GEcKyaw8RTk8G6
Chris Farhood added 1 commit 2026-07-21 01:05:35 +00:00
feat: add road-racing and TT demand docs (balance the MTB doc) cced0ea6b8 
The skill had mtb-xco-demands.md but road/TT demands were only diffused
through the general docs — an asymmetry given the balanced MTB+road scope.
Add two dedicated, self-contained demand profiles (kept separate because
mass-start racing and TT differ as much as XCO differs from marathon MTB):

- references/road-racing-demands.md: stochastic power profile (Vogt 2007,
  Ebert 2005/2006, Sanders/van Erp 2021), drafting economics (Blocken 2018),
  fatigued finishing sprint (Menaspà 2013/2015, Etxebarria 2019), durability
  as a success determinant (van Erp/Sanders/Lamberts 2021); power governs, HR
  unreliable (intermittent) — mirrors the MTB doc.
- references/tt-demands.md: aero drag dominance + CdA as the top lever
  (Crouch 2017, Martin 1998, García-López 2008), critical power as predictor
  (Smith 1999), even-vs-variable pacing (Swain 1997, Atkinson 2007), long-TT
  durability (Maunder 2021); HR more usable than MTB but still secondary.

All new quantitative claims carry verified PMIDs/DOIs (verified via PubMed/
CrossRef); citations.md gains Road-racing and Time-trial sections. Honesty
flags: Blocken 2018 and Martin 1998 have no PMID (DOI only); the '~90% aero'
soundbite (Kyle & Burke 1984) is unverifiable and marked approximate;
criterium-specific literature flagged as a gap; no unverified HR-reliability
citation added (TT HR defers to data-confounds.md).

Router (SKILL.md) and README layout updated with both docs.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TqrhBhC3GEcKyaw8RTk8G6
Chris Farhood added 1 commit 2026-07-21 01:14:32 +00:00
docs: cross-link general docs to the discipline demand docs 719928443a 
Tighten the router so race-specific reasoning in the general docs points to
the matching demand profile instead of speaking in a road/TT-default voice:

- periodization.md: anchor the build phase's 'race-specific top-end' to the
  matching demand doc (tt / road-racing / mtb-xco).
- durability.md: show how fatigue resistance manifests per discipline.
- data-confounds.md: extend the intermittent-HR caveat to road racing/crits;
  note TT as the steadier exception where HR is more usable.
- strength-for-cyclists.md: link the explosive/sprint transfer to road-racing
  and sustained-power transfer to TT.
- vo2max-intervals.md: match rep length to event (short=surges/road+MTB,
  long=sustained/TT); extend the HR caveat to road racing.

All internal links verified resolving.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TqrhBhC3GEcKyaw8RTk8G6
This pull request can be merged automatically.
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin feat/road-tt-demands:feat/road-tt-demands
git checkout feat/road-tt-demands
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
fl_blake (Blake MIddleware) cpfarhood (Chris Farhood) ci (Continuous Integration [bot]) flux (Flux CD) admin (Gitea Admin) fl_hugh (Hugh Commit) renovate (Mend Renovate) fl_warren (Warren Bufferpool)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: farhoodlabs/cycling-training#3
Delete Branch "feat/road-tt-demands"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?