From 5138541e03c2bbcec6beb848ac7b6f2b3ca9ce1e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Cl=C3=A9ment=20Rieux?= Date: Sat, 18 Jul 2026 09:50:35 +0200 Subject: [PATCH] docs: resync "Working today" section across the four translations The FR/ES/DE/IT "How it works" sections had drifted to an older, shorter feature list. Bring the "Working today" paragraph, the roadmap, the skills node in the mermaid diagram, the MCP tool count (93 -> 102), the test count (1270 -> 1397) and the coaching-skills count (twelve -> fifteen) in line with the current English README. Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/i18n/README.de.md | 81 ++++++++++++++++++++++++++++------- docs/i18n/README.es.md | 95 ++++++++++++++++++++++++++++++++---------- docs/i18n/README.fr.md | 90 ++++++++++++++++++++++++++++++--------- docs/i18n/README.it.md | 93 ++++++++++++++++++++++++++++++++--------- 4 files changed, 281 insertions(+), 78 deletions(-) diff --git a/docs/i18n/README.de.md b/docs/i18n/README.de.md index 1ed0590..3227a66 100644 --- a/docs/i18n/README.de.md +++ b/docs/i18n/README.de.md @@ -272,8 +272,8 @@ Mitwirkende. flowchart TB U[Du] <--> H[Dein Agenten-CLI
Claude Code · Gemini CLI · Codex
= der Coach: spricht, denkt, passt an] H <-->|MCP| S[performance-agent-Server] - H -.folgt.-> SK[Coaching-Skills
Onboarding · Bedarfsanalyse · Recherche · -Planung · Optimierung · Ernährung · Kontrolle · Check-ins · Anpassung] + H -.folgt.-> SK[Coaching-Skills
Onboarding · Bedarfsanalyse · Tiefenrecherche · +Planung · Optimierung · Ernährung · Review · Check-ins · Trainingstag · Anpassung] S --> E[Sportwissenschafts-Engine
deterministisch · property-getestet · null LLM] S --> EV[(Evidenzkorpus
bewertete Studien, SQLite FTS5)] S --> M[(Athletenverzeichnis
Profil · Programme · Protokolle — einfache Dateien)] @@ -290,25 +290,74 @@ Session-RPE-Last & ACWR, Monotonie/Strain, Form-Ermüdung CTL/ATL/TSB, Readiness-Einstufung, Budgetierung externer Last, Zielmachbarkeit, Periodisierungswellen, rückwärts geplante Saison aus einem datierten Kalender, Sitzungs-Autoregulation am Tag selbst (Readiness-basierte Anpassung, Zeitkompression, -Übungssubstitution), Sequenzierung innerhalb der Woche & Interferenzschutz, -individualisierte Rekalibrierung aus den Logs des Athleten (gemessene -Progressionsrate ehrlich über n, Soll-Ist-Compliance, Volumentoleranz, versioniertes -Antwortprofil), die die Machbarkeit neu berechnet, datengestützte -Entlastungsempfehlungen und eine schrittweise Rückkehr zur Last nach einer Pause, -proaktives Follow-up, das Fälliges hervorhebt, und eine deterministische -End-to-End-Simulation (ohne LLM); 1270 Tests inkl. property-based) · 93 MCP-Werkzeuge · -dateibasiertes Athletengedächtnis mit Saisonkalender, Readiness-Logs, versionierten -maschinenlesbaren Programmen, Tages-Anpassungsprotokoll, versioniertem Antwortprofil -und Anpassungs-Audit-Protokoll · Import von Aktivitätsdateien (.fit/.tcx/.gpx/CSV) · +Übungssubstitution), Sequenzierung innerhalb der Woche & Interferenzschutz (Abstand +schwerer Muster, HIIT-vor-Unterkörper-Interferenz, Regeln für aufeinanderfolgende harte +Tage und Match-Fenster), individualisierte Rekalibrierung aus den Logs des Athleten +(gemessene Progressionsrate ehrlich über n, Soll-Ist-Compliance, +Volumen-Toleranz-Assoziation, versioniertes Antwortprofil), die die Zielmachbarkeit +gegen die gemessene Rate neu berechnet, datengestützte Entlastungsempfehlungen +(Monotonie/Strain, TSB- und Readiness-Trends gegen den geplanten Zähler) und eine +gestufte Rückkehr zur Last nach einer Pause (freigabe-gesteuert), proaktives Follow-up, +das Fälliges hervorhebt (überfälliger Check-in, bevorstehender Wettkampf, verpasste +Sitzungen, Readiness-Lücken, veraltetes Antwortprofil) nach Schweregrad geordnet, damit +der Coach zuerst spricht, und eine deterministische End-to-End-Simulation (ohne LLM), +die die echte Engine + den Speicher über synthetische Athleten treibt — inklusive einer +NICHT VORBEREITETEN Sportart (Kajak-Sprint), deren handgeschriebenes Modell die gesamte +Pipeline genau wie ein vorbereitetes durchläuft und beweist, dass die Maschine +sportunabhängig ist — um zu beweisen, dass sich die ganze Schleife zusammensetzt, ein +sportagnostisches PerformanceModel (die recherchierte, versionierte Antwort auf „was +bestimmt die Leistung in dieser Disziplin" — trainierbare Qualitäten mit normalisierten +Gewichten, KPIs mit Niveau-Benchmarks, Verletzungsrisiken und Energiesystem-Aufteilung, +jeder Wert nach Herkunft gekennzeichnet: zitiert/a priori/Einschätzung), das die +Lückenanalyse antreibt (gemessene KPIs vs. Benchmarks, Trainingsprioritäten je +Qualität, Ungemessenes bleibt ungemessen) und eine datierte Testbatterie, die als +Experimente um den Kalender herum geplant wird, initialisiert mit vier Referenzmodellen +(Sprint, 10 km, Powerlifting, Fußball), die Beispiele und keine Voraussetzung sind, und +eine strukturierte Übungs-Ontologie (~120 Basisübungen attribuiert nach +Bewegungsmuster, Kraftvektor, Kontraktionsregime, kinetischer Kette, Ausrüstung, +Spezifitätsniveau und trainierten Qualitäten — filterbar und erweiterbar mit eigenen +Ergänzungen des Athleten) mit deterministischer bewerteter Übungsauswahl +(Qualitätsübereinstimmung × phasengerechte Spezifität × Ausrüstungs-Machbarkeit × +Kontraindikations-Sperre × Neuheit, gerankt mit einer Begründung je Attribut), +Reiz-Äquivalenz-Substitution und einem Mesozyklus-Spezifitätsmix-Schutz, plus +optionaler hochauflösender Datenaufnahme (Velocity-Based-Training-CSV-Importe als +strukturierte Sätze, .fit/.tcx-Einheiten liefern Leistung/normalisierte +Leistung/Kadenz/Runden-Splits, und Sprung-/Sprint-Messungen landen im KPI-Log — jede +hochauflösende Eingabe optional, fehlende Daten senken die angegebene Auflösung, statt +zu blockieren), Last-Geschwindigkeits-Profiling (eine je Übung angepasste +Geschwindigkeits-Last-Linie mit geschätztem 1RM, ehrlich abgesichert und abgelehnt, +wenn die Lasten zu wenige oder zu eng sind), das Tages-Geschwindigkeits-basierte +Last-Vorschläge speist (begrenzt, gekennzeichnet, nie automatisch angewandt), und ein +je Athlet angepasstes zweikomponentiges Banister-Impuls-Antwort-Modell +(deterministischer Pure-Python-Gitter-Fit der Form-/Ermüdungs-Zeitkonstanten und +Gewinne, ehrlich abgesichert — abgelehnt ohne ≥8 Wochen Last und ≥5 verteilte +Leistungspunkte oder bei fixierten/unplausiblen Werten — das die eigenen Zeitkonstanten +des Athleten in den Form-Ermüdungs-Trend einspeist), individuelle Taper-Antwort +(erkennt vergangene Taper im Last-Log, paart jeden mit seinem ereignisgebundenen +Ergebnis und empfiehlt Dauer/Reduktion aus dem besten Taper des Athleten selbst, wenn +≥2 vorhanden — sonst die gekennzeichnete Populationsregel) und Progressionsraten je +Qualität, die über die Modell-KPIs verschlüsselt sind, plus mehrjährige +Makrozyklus-Planung (ein 1–4-Jahres-Plan rückwärts vom Hauptevent typisiert mit +jährlichen Qualitäts-Schwerpunkt-Budgets, die aus den Lückenprioritäten abgeleitet sind +und die Saison speisen) und ein Trainingsresiduen-Schutz (warnt, wo eine gehaltene +Qualität ohne Auffrischung über ihr Issurin-Retentionsfenster hinaus abfallen würde); +1397 Tests inkl. property-based) · 102 MCP-Werkzeuge · dateibasiertes Athletengedächtnis +mit Saisonkalender, Readiness-Logs vor der Sitzung, versionierten maschinenlesbaren +Programmen (strukturierter Plan + gerendertes Markdown), Tages-Anpassungsprotokoll mit +Eskalationssignalen, versioniertem individuellem Antwortprofil, versionierten +Performance-Modellen, datiertem KPI-Ergebnis-Log und Anpassungs-Audit-Protokoll · +Import von Aktivitätsdateien (.fit/.tcx/.gpx/CSV, inkl. Leistung/Kadenz/Splits und +VBT-Exporte), der eine Sitzung vorschlägt, die der Athlet vor dem Loggen bestätigt · DOI/PMID/ISBN-verifizierter Evidenzkorpus mit Anti-Fabrikations-Zitatprüfung · Live-Evidenzsuche (PubMed, OpenAlex, Crossref, Semantic Scholar) hinter doppelter -Verifikation · zwölf Coaching-Skills inkl. verpflichtendem Liefer-Gate mit +Verifikation · fünfzehn Coaching-Skills inkl. verpflichtendem Liefer-Gate mit adversarialer Zweitmeinung · Typst-PDF-Berichte (en/fr/es) hinter einer harten Zitatsperre. -**Roadmap:** Korpusausbau auf ~200 Studien · Ergebnissimulation (Banister + -Monte Carlo) · weitere Sport-Vertikalen (Hyrox-spezifische Engine-Werkzeuge, Fußball, -Tennis) · optionales Web-Frontend auf demselben MCP-Server. +**Roadmap:** Umgebung & Fein-Peaking (Höhe/Hypoxie, Hitzeakklimatisation, +Jetlag-Protokolle, Wettkampfstunden-Planung) — die bewusste nächste Iteration · +Korpusausbau auf ~200 Studien · Ergebnissimulation (Monte Carlo auf dem angepassten +Banister-Modell) · optionales Web-Frontend auf demselben MCP-Server. ## Designprinzipien diff --git a/docs/i18n/README.es.md b/docs/i18n/README.es.md index d81fcf5..96399d2 100644 --- a/docs/i18n/README.es.md +++ b/docs/i18n/README.es.md @@ -266,8 +266,8 @@ Cualquier otra herramienta compatible con servidores MCP funciona con el mismo c flowchart TB U[Tú] <--> H[Tu agente CLI
Claude Code · Gemini CLI · Codex
= el coach: conversa, razona, adapta] H <-->|MCP| S[servidor performance-agent] - H -.sigue.-> SK[Habilidades de coaching
onboarding · análisis de necesidades · investigación · -planificación · optimización · nutrición · control · revisiones · adaptación] + H -.sigue.-> SK[Habilidades de coaching
onboarding · análisis de necesidades · investigación profunda · +planificación · optimización · nutrición · revisión · check-ins · día de sesión · adaptación] S --> E[Motor de ciencias del deporte
determinista · testeado por propiedades · cero LLM] S --> EV[(Corpus de evidencia
estudios graduados, SQLite FTS5)] S --> M[(Directorio del atleta
perfil · programas · registros — archivos simples)] @@ -285,26 +285,77 @@ clasificación de readiness, presupuesto de carga externa, viabilidad de objetiv ondas de periodización, planificación de temporada hacia atrás desde un calendario con fechas, autorregulación de la sesión el mismo día (ajuste según la readiness, compresión del tiempo, sustitución de ejercicios), secuenciación intrasemanal y -salvaguarda de interferencia, recalibración individualizada a partir de los registros -del atleta (ritmo de progresión medido honesto sobre n, cumplimiento prescrito-vs-real, -tolerancia al volumen, perfil de respuesta versionado) que recalcula la viabilidad, -recomendaciones de descarga basadas en datos y rampa progresiva de retorno a la carga -tras una pausa, seguimiento proactivo que hace aflorar lo que toca, y una simulación -determinista de extremo a extremo (sin LLM); 1270 tests, incl. basados en propiedades) -· 93 herramientas MCP · memoria del atleta en archivos con calendario de temporada, -registros de readiness, programas versionados legibles por máquina, registro de ajustes -del día, perfil de respuesta versionado e historial de auditoría de adaptaciones · -importación de archivos de actividad (.fit/.tcx/.gpx/CSV) · corpus de evidencia -verificada por DOI/PMID/ISBN con control anti-fabricación de citas · búsqueda de -evidencia en vivo (PubMed, OpenAlex, Crossref, Semantic Scholar) tras una doble -verificación · doce habilidades de coaching, incl. una puerta de entrega obligatoria -con segunda opinión adversarial · informes PDF Typst (en/fr/es) tras un bloqueo -estricto de citas. - -**Hoja de ruta:** ampliación del corpus hacia ~200 estudios · simulación de resultados -(Banister + Monte Carlo) · más verticales deportivas (herramientas de motor -específicas de Hyrox, fútbol, tenis) · front-end web opcional reutilizando el mismo -servidor MCP. +salvaguarda de interferencia (espaciado de patrones pesados, interferencia +HIIT-antes-de-tren-inferior, reglas de días fuertes consecutivos y de ventana de +partido), recalibración individualizada a partir de los registros del atleta (ritmo de +progresión medido honesto sobre n, cumplimiento prescrito-vs-real, asociación +tolerancia-volumen, perfil de respuesta versionado) que recalcula la viabilidad del +objetivo frente al ritmo medido, recomendaciones de descarga basadas en datos +(monotonía/tensión, tendencias de TSB y readiness frente al contador planificado) y +rampa progresiva de retorno a la carga tras una pausa (condicionada a un visto bueno), +seguimiento proactivo que hace aflorar lo que toca (check-in atrasado, carrera +inminente, sesiones perdidas, brechas de readiness, perfil de respuesta caducado) +ordenado por gravedad para que el coach hable primero, y una simulación determinista de +extremo a extremo (sin LLM) que impulsa el motor real + el almacén sobre atletas +sintéticos — incluido un deporte SIN PRECARGAR (kayak sprint) cuyo modelo escrito a +mano recorre toda la cadena exactamente como uno precargado, demostrando que la máquina +es independiente del deporte — para probar que todo el bucle se ensambla, un +PerformanceModel agnóstico al deporte (la respuesta investigada y versionada a «qué +determina el rendimiento en esta prueba» — cualidades entrenables con pesos +normalizados, KPI con referencias por nivel, riesgos de lesión y reparto de sistemas +energéticos, cada valor etiquetado por procedencia: citado/a priori/juicio) que impulsa +el análisis de brechas (KPI medidos vs referencias, prioridades de entrenamiento por +cualidad, lo no medido sigue sin medir) y una batería de pruebas con fechas planificada +como experimentos alrededor del calendario, inicializada con cuatro modelos de +referencia (sprint, 10 km, powerlifting, fútbol) que son ejemplos y no un requisito, y +una ontología de ejercicios estructurada (~120 ejercicios base atribuidos por patrón de +movimiento, vector de fuerza, régimen de contracción, cadena cinética, equipamiento, +nivel de especificidad y cualidades entrenadas — filtrables y extensibles con las +adiciones del atleta) con selección de ejercicios puntuada determinista +(correspondencia de cualidad × especificidad apropiada a la fase × viabilidad de +equipamiento × bloqueo por contraindicación × novedad, clasificada con una +justificación por atributo), sustitución por equivalencia de estímulo y salvaguarda de +mezcla de especificidad en el mesociclo, además de una ingesta opcional de datos de +alta resolución (importaciones CSV de entrenamiento basado en velocidad como series +estructuradas, salidas .fit/.tcx que dan potencia/potencia normalizada/cadencia/ +parciales, y mediciones de salto/sprint que van al registro de KPI — cada entrada de +alta resolución opcional, un dato faltante baja la resolución declarada en vez de +bloquear), perfilado carga-velocidad (una recta velocidad-carga ajustada por ejercicio +con un 1RM estimado, controlada honestamente y rechazada cuando las cargas son +demasiado pocas o demasiado estrechas) que alimenta sugerencias de carga basadas en +velocidad el mismo día (acotadas, etiquetadas, nunca aplicadas automáticamente), y un +modelo de respuesta al impulso de Banister de dos componentes ajustado por atleta +(ajuste por rejilla en Python puro de las constantes de tiempo forma/fatiga y las +ganancias, controlado honestamente — rechazado sin ≥8 semanas de carga y ≥5 puntos de +rendimiento espaciados, o cuando están fijados/inverosímiles — inyectando las propias +constantes de tiempo del atleta en la tendencia forma-fatiga), respuesta individual al +afinamiento (detecta afinamientos pasados en el registro de carga, empareja cada uno +con su resultado ligado a un evento, y recomienda duración/reducción desde el mejor +afinamiento del propio atleta cuando hay ≥2 — si no, la regla poblacional etiquetada) y +ritmos de progresión por cualidad indexados a los KPI del modelo, además de +planificación de macrociclo plurianual (un plan de 1 a 4 años tipado hacia atrás desde +el evento principal con presupuestos de énfasis por cualidad y año derivados de las +prioridades de brecha, alimentando la temporada) y una salvaguarda de residuos de +entrenamiento (avisa donde una cualidad mantenida decaería más allá de su ventana de +retención de Issurin sin un refresco); 1397 tests, incl. basados en propiedades) · 102 +herramientas MCP · memoria del atleta en archivos con calendario de temporada, +registros de readiness previos a la sesión, programas versionados legibles por máquina +(plan estructurado + markdown renderizado), registro de ajustes del día con señales de +escalada, perfil de respuesta individual versionado, modelos de rendimiento +versionados, registro de resultados de KPI con fechas e historial de auditoría de +adaptaciones · importación de archivos de actividad (.fit/.tcx/.gpx/CSV, incl. +potencia/cadencia/parciales y exportaciones VBT) que propone una sesión para que el +atleta la confirme antes de registrarla · corpus de evidencia verificada por +DOI/PMID/ISBN con control anti-fabricación de citas · búsqueda de evidencia en vivo +(PubMed, OpenAlex, Crossref, Semantic Scholar) tras una doble verificación · quince +habilidades de coaching, incl. una puerta de entrega obligatoria con segunda opinión +adversarial · informes PDF Typst (en/fr/es) tras un bloqueo estricto de citas. + +**Hoja de ruta:** entorno y afinado del pico de forma (altitud/hipoxia, aclimatación al +calor, protocolos de desfase horario, planificación según la hora de competición) — la +siguiente iteración deliberada · ampliación del corpus hacia ~200 estudios · simulación +de resultados (Monte Carlo sobre el modelo de Banister ajustado) · front-end web +opcional reutilizando el mismo servidor MCP. ## Principios de diseño diff --git a/docs/i18n/README.fr.md b/docs/i18n/README.fr.md index 84896f8..3478da3 100644 --- a/docs/i18n/README.fr.md +++ b/docs/i18n/README.fr.md @@ -270,8 +270,8 @@ les contributeurs. flowchart TB U[Vous] <--> H[Votre agent CLI
Claude Code · Gemini CLI · Codex
= le coach : converse, raisonne, adapte] H <-->|MCP| S[serveur performance-agent] - H -.suit.-> SK[Compétences de coaching
accueil · analyse des besoins · recherche · -planification · optimisation · nutrition · contrôle · bilans · adaptation] + H -.suit.-> SK[Compétences de coaching
accueil · analyse des besoins · recherche approfondie · +planification · optimisation · nutrition · revue · bilans · jour-J · adaptation] S --> E[Moteur de science du sport
déterministe · testé par propriétés · zéro LLM] S --> EV[(Corpus de preuves
études gradées, SQLite FTS5)] S --> M[(Dossier athlète
profil · programmes · journaux — fichiers simples)] @@ -289,24 +289,74 @@ CTL/ATL/TSB, classement de readiness, budgétisation de charge externe, faisabil d'objectif, vagues de périodisation, planification de saison à rebours depuis un calendrier daté, autorégulation de séance le jour même (ajustement selon la readiness, compression du temps, substitution d'exercices), séquençage intra-semaine & garde-fou -d'interférence, recalibrage individualisé à partir des journaux de l'athlète (taux de -progression mesuré honnête sur n, conformité prescrit-vs-réalisé, tolérance au volume, -profil de réponse versionné) qui recalcule la faisabilité, recommandations de décharge -fondées sur les données et rampe progressive de retour à la charge après une coupure, -suivi proactif qui fait remonter ce qui est dû, et une simulation déterministe de bout -en bout (sans LLM) ; 1270 tests dont des tests par propriétés) · 93 outils MCP · -mémoire athlète en fichiers avec calendrier de saison, journaux de readiness, -programmes versionnés lisibles par machine, journal d'ajustements du jour, profil de -réponse versionné et journal d'audit des adaptations · import de fichiers d'activité -(.fit/.tcx/.gpx/CSV) · corpus de preuves vérifiées par DOI/PMID/ISBN avec contrôle -anti-fabrication des citations · recherche bibliographique en direct (PubMed, OpenAlex, -Crossref, Semantic Scholar) derrière une double vérification · douze compétences de -coaching dont un portail de livraison obligatoire avec contre-expertise adversariale · -rapports PDF Typst (en/fr/es) derrière un verrou strict de citations. - -**Feuille de route :** corpus étendu vers ~200 études · simulation de résultats -(Banister + Monte Carlo) · nouvelles verticales sportives (outils moteur spécifiques -Hyrox, football, tennis) · front-end web optionnel réutilisant le même serveur MCP. +d'interférence (espacement des schémas lourds, interférence HIIT-avant-bas-du-corps, +règles de jours-forts consécutifs et de fenêtre de match), recalibrage individualisé à +partir des journaux de l'athlète (taux de progression mesuré honnête sur n, conformité +prescrit-vs-réalisé, association tolérance-volume, profil de réponse versionné) qui +recalcule la faisabilité de l'objectif face au taux mesuré, recommandations de décharge +fondées sur les données (monotonie/contrainte, tendances TSB et readiness face au +compteur planifié) et rampe progressive de retour à la charge après une coupure +(conditionnée à un feu vert), suivi proactif qui fait remonter ce qui est dû (bilan en +retard, course imminente, séances manquées, écarts de readiness, profil de réponse +périmé) trié par sévérité pour que le coach parle en premier, et une simulation +déterministe de bout en bout (sans LLM) qui pilote le vrai moteur + le stockage sur des +athlètes synthétiques — dont un sport NON PRÉ-CHARGÉ (kayak sprint) dont le modèle écrit +à la main traverse toute la chaîne exactement comme un modèle pré-chargé, prouvant que +la machine est indépendante du sport — pour prouver que toute la boucle s'assemble, un +PerformanceModel agnostique au sport (la réponse recherchée et versionnée à « qu'est-ce +qui détermine la performance dans cette épreuve » — qualités entraînables à poids +normalisés, KPI avec repères par niveau, risques de blessure et répartition des filières +énergétiques, chaque valeur étiquetée par provenance : citée/a priori/jugement) qui +pilote l'analyse des écarts (KPI mesurés vs repères, priorités d'entraînement par +qualité, le non-mesuré reste non-mesuré) et une batterie de tests datée planifiée comme +des expériences autour du calendrier, initialisée avec quatre modèles de référence +(sprint, 10 km, powerlifting, football) qui sont des exemples et non un prérequis, et une +ontologie d'exercices structurée (~120 exercices de base attribués par schéma moteur, +vecteur de force, régime de contraction, chaîne cinétique, matériel, niveau de +spécificité et qualités entraînées — filtrables et extensibles avec les ajouts de +l'athlète) avec sélection d'exercices scorée déterministe (correspondance de qualité × +spécificité adaptée à la phase × faisabilité matériel × verrou de contre-indication × +nouveauté, classée avec une justification par attribut), substitution à équivalence de +stimulus et garde-fou de mix de spécificité sur le mésocycle, plus une ingestion +optionnelle de données haute résolution (imports CSV d'entraînement basé sur la vitesse +en séries structurées, sorties .fit/.tcx donnant puissance/puissance normalisée/cadence/ +splits, et mesures de saut/sprint versées au journal des KPI — chaque entrée haute +résolution optionnelle, une donnée manquante abaisse la résolution annoncée plutôt que +de bloquer), profilage charge-vitesse (une droite vitesse-charge ajustée par exercice +avec un 1RM estimé, contrôlée honnêtement et refusée quand les charges sont trop peu +nombreuses ou trop resserrées) qui alimente des suggestions de charge basées sur la +vitesse le jour même (bornées, étiquetées, jamais appliquées automatiquement), et un +modèle de réponse impulsionnelle de Banister à deux composantes ajusté par athlète +(ajustement par grille en pur Python des constantes de temps forme/fatigue et des gains, +contrôlé honnêtement — refusé sans ≥8 semaines de charge et ≥5 points de performance +étalés, ou en cas de valeurs bloquées/invraisemblables — injectant les propres constantes +de temps de l'athlète dans la tendance forme-fatigue), réponse individuelle à l'affûtage +(détecte les affûtages passés dans le journal de charge, apparie chacun à son résultat +lié à un événement, et recommande durée/réduction depuis le meilleur affûtage de +l'athlète quand il y en a ≥2 — sinon la règle de population étiquetée) et taux de +progression par qualité indexés sur les KPI du modèle, plus une planification de +macrocycle pluriannuelle (un plan de 1 à 4 ans typé à rebours depuis l'événement majeur +avec des budgets d'emphase par qualité et par an dérivés des priorités d'écart, alimentant +la saison) et un garde-fou de résidus d'entraînement (avertit là où une qualité maintenue +déclinerait au-delà de sa fenêtre de rétention d'Issurin sans rappel) ; 1397 tests dont +des tests par propriétés) · 102 outils MCP · mémoire athlète en fichiers avec calendrier +de saison, journaux de readiness avant séance, programmes versionnés lisibles par machine +(plan structuré + markdown rendu), journal d'ajustements du jour avec signaux +d'escalade, profil de réponse individuel versionné, modèles de performance versionnés, +journal de résultats de KPI daté et journal d'audit des adaptations · import de fichiers +d'activité (.fit/.tcx/.gpx/CSV, incl. puissance/cadence/splits et exports VBT) qui +propose une séance à confirmer par l'athlète avant journalisation · corpus de preuves +vérifiées par DOI/PMID/ISBN avec contrôle anti-fabrication des citations · recherche +bibliographique en direct (PubMed, OpenAlex, Crossref, Semantic Scholar) derrière une +double vérification · quinze compétences de coaching dont un portail de livraison +obligatoire avec contre-expertise adversariale · rapports PDF Typst (en/fr/es) derrière +un verrou strict de citations. + +**Feuille de route :** environnement & affinage du pic de forme (altitude/hypoxie, +acclimatation à la chaleur, protocoles de décalage horaire, planification selon l'heure +de compétition) — la prochaine itération assumée · corpus étendu vers ~200 études · +simulation de résultats (Monte Carlo sur le modèle de Banister ajusté) · front-end web +optionnel réutilisant le même serveur MCP. ## Principes de conception diff --git a/docs/i18n/README.it.md b/docs/i18n/README.it.md index f4fb2a4..bf01943 100644 --- a/docs/i18n/README.it.md +++ b/docs/i18n/README.it.md @@ -266,8 +266,8 @@ contribuisce. flowchart TB U[Tu] <--> H[Il tuo agente CLI
Claude Code · Gemini CLI · Codex
= il coach: conversa, ragiona, adatta] H <-->|MCP| S[server performance-agent] - H -.segue.-> SK[Skill di coaching
onboarding · analisi dei bisogni · ricerca · -pianificazione · ottimizzazione · nutrizione · controllo · check-in · adattamento] + H -.segue.-> SK[Skill di coaching
onboarding · analisi dei bisogni · ricerca approfondita · +pianificazione · ottimizzazione · nutrizione · revisione · check-in · giorno di seduta · adattamento] S --> E[Motore di scienze dello sport
deterministico · testato per proprietà · zero LLM] S --> EV[(Corpus di evidenze
studi classificati, SQLite FTS5)] S --> M[(Cartella atleta
profilo · programmi · registri — semplici file)] @@ -285,24 +285,77 @@ classificazione della readiness, budget del carico esterno, fattibilità degli obiettivi, onde di periodizzazione, pianificazione della stagione a ritroso da un calendario con date, autoregolazione della seduta in giornata (aggiustamento in base alla readiness, compressione del tempo, sostituzione degli esercizi), sequenziamento -intra-settimana e guardia sulle interferenze, ricalibrazione individualizzata dai log -dell'atleta (tasso di progressione misurato onesto su n, conformità prescritto-vs-reale, -tolleranza al volume, profilo di risposta versionato) che ricalcola la fattibilità, -raccomandazioni di scarico basate sui dati e rampa progressiva di ritorno al carico -dopo una pausa, follow-up proattivo che fa emergere ciò che è dovuto, e una simulazione -deterministica end-to-end (senza LLM); 1270 test incl. property-based) · 93 strumenti -MCP · memoria atleta su file con calendario di stagione, log di readiness, programmi -versionati leggibili dalla macchina, registro degli aggiustamenti in giornata, profilo -di risposta versionato e registro di audit degli adattamenti · import di file di -attività (.fit/.tcx/.gpx/CSV) · corpus di evidenze verificate via DOI/PMID/ISBN con -controllo anti-fabbricazione delle citazioni · ricerca di evidenze in tempo reale -(PubMed, OpenAlex, Crossref, Semantic Scholar) dietro doppia verifica · dodici skill di -coaching incl. un gate di consegna obbligatorio con seconda opinione avversariale · -report PDF Typst (en/fr/es) dietro un blocco rigido delle citazioni. - -**Roadmap:** crescita del corpus verso ~200 studi · simulazione dei risultati -(Banister + Monte Carlo) · nuove verticali sportive (strumenti del motore specifici -per Hyrox, calcio, tennis) · front-end web opzionale che riusa lo stesso server MCP. +intra-settimana e guardia sulle interferenze (spaziatura dei pattern pesanti, +interferenza HIIT-prima-del-treno-inferiore, regole di giorni forti consecutivi e di +finestra di match), ricalibrazione individualizzata dai log dell'atleta (tasso di +progressione misurato onesto su n, conformità prescritto-vs-reale, associazione +tolleranza-volume, profilo di risposta versionato) che ricalcola la fattibilità +dell'obiettivo rispetto al tasso misurato, raccomandazioni di scarico basate sui dati +(monotonia/strain, tendenze di TSB e readiness rispetto al contatore pianificato) e +rampa progressiva di ritorno al carico dopo una pausa (subordinata a un via libera), +follow-up proattivo che fa emergere ciò che è dovuto (check-in in ritardo, gara +imminente, sedute saltate, lacune di readiness, profilo di risposta scaduto) ordinato +per gravità perché il coach parli per primo, e una simulazione deterministica +end-to-end (senza LLM) che pilota il motore reale + l'archivio su atleti sintetici — +incluso uno sport NON PRECARICATO (kayak sprint) il cui modello scritto a mano +attraversa l'intera catena esattamente come uno precaricato, dimostrando che la +macchina è indipendente dallo sport — per dimostrare che l'intero ciclo si compone, un +PerformanceModel agnostico allo sport (la risposta ricercata e versionata a «cosa +determina la prestazione in questa prova» — qualità allenabili con pesi normalizzati, +KPI con benchmark per livello, rischi di infortunio e ripartizione dei sistemi +energetici, ogni valore etichettato per provenienza: citato/a priori/giudizio) che +pilota l'analisi delle lacune (KPI misurati vs benchmark, priorità di allenamento per +qualità, il non misurato resta non misurato) e una batteria di test con date +pianificata come esperimenti attorno al calendario, inizializzata con quattro modelli +di riferimento (sprint, 10 km, powerlifting, calcio) che sono esempi e non un +prerequisito, e un'ontologia degli esercizi strutturata (~120 esercizi di base +attribuiti per pattern di movimento, vettore di forza, regime di contrazione, catena +cinetica, attrezzatura, livello di specificità e qualità allenate — filtrabili ed +estensibili con le aggiunte dell'atleta) con selezione degli esercizi punteggiata +deterministica (corrispondenza di qualità × specificità appropriata alla fase × +fattibilità attrezzatura × blocco per controindicazione × novità, classificata con una +giustificazione per attributo), sostituzione a equivalenza di stimolo e guardia sul mix +di specificità del mesociclo, oltre a un'ingestione opzionale di dati ad alta +risoluzione (importazioni CSV di allenamento basato sulla velocità come serie +strutturate, uscite .fit/.tcx che danno potenza/potenza normalizzata/cadenza/parziali, +e misurazioni di salto/sprint che finiscono nel log dei KPI — ogni input ad alta +risoluzione opzionale, un dato mancante abbassa la risoluzione dichiarata invece di +bloccare), profilazione carico-velocità (una retta velocità-carico adattata per +esercizio con un 1RM stimato, controllata onestamente e rifiutata quando i carichi sono +troppo pochi o troppo ristretti) che alimenta suggerimenti di carico basati sulla +velocità in giornata (limitati, etichettati, mai applicati automaticamente), e un +modello di risposta all'impulso di Banister a due componenti adattato per atleta (fit a +griglia in puro Python delle costanti di tempo forma/fatica e dei guadagni, controllato +onestamente — rifiutato senza ≥8 settimane di carico e ≥5 punti di prestazione +distribuiti, o con valori fissati/inverosimili — che immette le costanti di tempo +dell'atleta stesso nella tendenza forma-fatica), risposta individuale al tapering +(rileva i tapering passati nel log del carico, abbina ciascuno al suo risultato legato +a un evento, e raccomanda durata/riduzione dal miglior tapering dell'atleta stesso +quando ce ne sono ≥2 — altrimenti la regola di popolazione etichettata) e tassi di +progressione per qualità indicizzati sui KPI del modello, oltre alla pianificazione di +macrociclo pluriennale (un piano da 1 a 4 anni tipizzato a ritroso dall'evento +principale con budget di enfasi per qualità e per anno derivati dalle priorità delle +lacune, che alimentano la stagione) e una guardia sui residui di allenamento (avverte +dove una qualità mantenuta decadrebbe oltre la sua finestra di ritenzione di Issurin +senza un richiamo); 1397 test incl. property-based) · 102 strumenti MCP · memoria +atleta su file con calendario di stagione, log di readiness pre-seduta, programmi +versionati leggibili dalla macchina (piano strutturato + markdown renderizzato), +registro degli aggiustamenti in giornata con segnali di escalation, profilo di risposta +individuale versionato, modelli di prestazione versionati, log dei risultati KPI con +date e registro di audit degli adattamenti · import di file di attività +(.fit/.tcx/.gpx/CSV, incl. potenza/cadenza/parziali ed export VBT) che propone una +seduta da confermare dall'atleta prima di registrarla · corpus di evidenze verificate +via DOI/PMID/ISBN con controllo anti-fabbricazione delle citazioni · ricerca di +evidenze in tempo reale (PubMed, OpenAlex, Crossref, Semantic Scholar) dietro doppia +verifica · quindici skill di coaching incl. un gate di consegna obbligatorio con +seconda opinione avversariale · report PDF Typst (en/fr/es) dietro un blocco rigido +delle citazioni. + +**Roadmap:** ambiente e affinamento del picco di forma (altitudine/ipossia, +acclimatazione al caldo, protocolli di jet-lag, pianificazione secondo l'ora di gara) — +la prossima iterazione deliberata · crescita del corpus verso ~200 studi · simulazione +dei risultati (Monte Carlo sul modello di Banister adattato) · front-end web opzionale +che riusa lo stesso server MCP. ## Principi di progettazione