Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
51985be
Add living evidence + weekly follow-up design spec
clementrx Jul 17, 2026
16a2c98
Add living evidence + weekly follow-up implementation plan
clementrx Jul 17, 2026
1a2757f
Add athlete documentation folder registry and scan
clementrx Jul 17, 2026
2504a54
Add documentation drop folder tools and write_profile bootstrap
clementrx Jul 17, 2026
dcbb608
Add structured ProgressionRule to exercise blocks
clementrx Jul 17, 2026
a85e0c4
Add pure next-load progression engine
clementrx Jul 17, 2026
4024113
Add weekly loads review with week matching and rule dispatch
clementrx Jul 17, 2026
b483579
Add watch report versioned doc family
clementrx Jul 17, 2026
e62a4f8
Add suggest_next_week_loads and save_watch_report tools
clementrx Jul 17, 2026
1d4faed
Surface loads-review and program-watch due actions
clementrx Jul 17, 2026
e8e0210
Record a loads review in the all-green diligence fixture
clementrx Jul 17, 2026
258c4ba
Add Guidance advice/rationale to ProgramPlan
clementrx Jul 17, 2026
0824eb2
Resolve plan citation ids against the corpus
clementrx Jul 17, 2026
695b812
Render advice, rationale and starred bibliography in program views
clementrx Jul 17, 2026
e0b692c
Resolve and render plan citations at save time
clementrx Jul 17, 2026
10b8bb6
Add next-week-loads skill
clementrx Jul 17, 2026
b5f7d18
Add program-watch skill
clementrx Jul 17, 2026
b4502b4
Wire documents, mini-waves and weekly follow-up into the skills
clementrx Jul 17, 2026
f0e8a7b
Document the living-evidence and weekly follow-up features
clementrx Jul 17, 2026
3ae1d1d
Check off completed plan tasks
clementrx Jul 17, 2026
44d2612
Bump version to 0.8.0
clementrx Jul 17, 2026
1e13fc0
Update lockfile for 0.8.0
clementrx Jul 17, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 30 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,36 @@

All notable changes to PerformanceAgent. Versions follow the git tags.

## 0.8.0 — Living Evidence & Weekly Follow-up

### Added

- **Athlete document drop folder** — every athlete directory gets a
`documentation/` folder (created at onboarding); drop studies, physio reports,
lab results or past programs there and the coach picks them up at the next
conversation. Verified studies (DOI/PMID/ISBN) join the evidence corpus;
everything else informs coaching as context, never presented as science.
New tools: `list_athlete_documents`, `mark_document_processed`.
- **Weekly loads review** — exercise blocks now carry a structured `progression`
rule (double progression, linear load, RIR target, %1RM, none) and the new
`suggest_next_week_loads` tool computes next week's exact working weights from
the logged week — deterministic engine math with flags instead of guesses
(`no_rule`, `failed_sets`, `clamped`, `no_matched_week`, …). New skill:
`next-week-loads`. The review never modifies the program.
- **Program watch** — a biweekly per-exercise audit (keep / watch / substitution
candidate) written as an immutable versioned report under `watch/` via
`save_watch_report`; substitutions route through program-adaptation, never
silently. New skill: `program-watch`. `list_due_actions` now surfaces an
overdue loads review and an unaudited program.
- **Science on the gym page** — programs can carry cited `advice` and
`rationale` lines; the markdown and offline HTML open with them and close
with a starred bibliography (`[n]` markers on citing blocks, DOI links).
`save_program` refuses any citation id not in the evidence corpus.
- **Research that stays alive** — deep-research gains document intake (step 0),
targeted mini-waves on plateaus/injuries/athlete questions, and an
incremental literature watch (`year_from` delta queries) at every mesocycle
boundary, all folded into the versioned dossier.

## 0.7.0 — Dated Program Filenames

### Changed
Expand Down
24 changes: 20 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,22 @@ tell you what you want to hear. PerformanceAgent is architected so neither is po
is *fitted*: your own fitness-fatigue time constants, taper response and per-quality
rates — with honesty gates that refuse a number when the data is too thin — planned
across a 1-4 year macrocycle.
- **Athlete document drop folder** — drop studies, physio reports or past
programs into `documentation/`; verified studies join the evidence corpus
(full text read), everything else informs coaching as context, never faked
as science.
- **Research that stays alive** — targeted mini-waves on plateaus, injuries and
athlete questions; an incremental literature watch at every mesocycle
boundary (`year_from` delta queries), all folded into the versioned dossier.
- **Weekly loads review** — structured per-block progression rules computed by
the engine (`suggest_next_week_loads`): next week's exact weights from this
week's logs, flags instead of guesses.
- **Program watch** — a biweekly per-exercise audit (keep / watch / substitute
candidate) written as a versioned report; substitutions go through
program-adaptation, never silently.
- **Science on the gym page** — the offline program HTML opens with sourced
advice and "why this program" lines, `[n]` markers on blocks, and a starred
bibliography.

## Install (5 minutes, 3 steps)

Expand Down Expand Up @@ -108,7 +124,7 @@ session *starts*: close any open session completely and run `claude` again.
> List the performance-agent tools.
```

You should see 93 tools. If so, you're done — just talk to it.
You should see 97 tools. If so, you're done — just talk to it.

## How to use it, step by step

Expand Down Expand Up @@ -315,8 +331,8 @@ typed backward from the major event with per-year quality-emphasis budgets deriv
from the gap priorities, feeding the season) and a training-residuals guard (warns
where a maintained quality would decay past its Issurin retention window without a
refresh);
1270 tests
incl. property-based) · 93 MCP
1339 tests
incl. property-based) · 97 MCP
tools · file-based athlete memory with a season calendar, pre-session readiness
logs, versioned machine-readable programs (structured plan + rendered markdown),
a day-of adjustment log with escalation signals, a versioned individual response
Expand All @@ -326,7 +342,7 @@ activity-file import (.fit/.tcx/.gpx/CSV, incl. power/cadence/splits and VBT
exports) that proposes a session for the athlete to confirm before logging ·
DOI/PMID/ISBN-verified evidence corpus with anti-fabrication
citation checks · live evidence search (PubMed, OpenAlex, Crossref, Semantic Scholar)
behind a double verification gate · twelve coaching skills incl. a mandatory delivery
behind a double verification gate · fourteen coaching skills incl. a mandatory delivery
gate with an adversarial second opinion · Typst PDF reports (en/fr/es) behind a hard
citation gate.

Expand Down
Loading