Aller au contenu

Premier démarrage (coach-setup)

Au premier lancement, aucun agent ne sait qui vous êtes. /coach-setup mène un entretien court et écrit le résultat au bon endroit.

Ligne de départ

En vidéo · Étape 01 · 1 min 45

Ligne de départ — Du git clone au premier /today : installation, authentification Garmin, /coach-setup et /coach-doctor en moins de deux minutes.

Regarder · English · Toutes les vidéos

Lancer

/coach-setup

Depuis n'importe quel IDE supporté. Les agents le proposent aussi d'eux-mêmes tant qu'aucune configuration n'existe — ils le proposent, ils ne l'imposent pas.

Ce qui est demandé

Question Ce qu'elle règle
Style de coaching Comment le coach vous parle — voir Styles de coaching
Fermeté Avec quelle force le style s'applique
Longueur Taille des retours de séance et des rapports
Discipline Trail/ultra ou route — charge le profil de sport correspondant
Sports croisés Pris en compte dans la planification hebdomadaire
Staff Quels agents installer ; seuls ceux-là sont joignables
Bilan matinal Si l'entraînement dépend de la HRV, de la FC de repos et de la readiness
Langues Langue des documents, langue des réponses
Unités Métriques ou impériales
Cycle menstruel Facultatif, neutre, posé une seule fois (off par défaut) : contexte du bilan matinal, voir Cycle menstruel

Où vont les réponses

Destination Contenu
config/workspace.user.toml Les réglages ci-dessus. Gitignoré.
planning/Runner_Profile.md Votre profil : physiologie, blessures, matériel, préférences. Installé depuis un modèle, rempli en conversation.
planning/active_objective.md L'objectif en cours, installé depuis un modèle.

L'application macOS utilise aussi coach_setup.py --apply-shoes pour ajouter les paires saisies pendant l'assistant. La commande ajoute des puces conformes à la section ### Chaussures, ignore une paire de même nom déjà présente et ne remplace jamais la paire par défaut existante.

Elle utilise --apply-objective pour compléter les champs vides de planning/active_objective.md depuis le questionnaire graphique. Les libellés restent ceux du modèle et un objectif déjà saisi n'est jamais écrasé.

Pré-remplissage physiologique depuis Garmin

Si le serveur MCP garmin répond, le coach essaie de récupérer :

  • votre FC max, observée comme le maximum de vos séances course à pied/trail des 180 derniers jours (pas une vraie FC max testée : une borne basse, affichée comme telle, et seulement à partir de 5 séances) ;
  • votre FC de repos, comme moyenne sur 7 jours (jamais la valeur du seul jour) — sauf si vous avez coupé le bilan matinal ([health].morning_check = "off"), auquel cas ce champ n'est même pas interrogé ;
  • votre FC au seuil (LTHR) et votre dernier VO2max.

Il vous montre chaque valeur trouvée avec sa source et sa date — vous confirmez ou corrigez, rien n'est écrit sans votre accord. Hors ligne, en cas d'erreur Garmin, ou si une métrique manque : le coach repasse silencieusement à la question classique, sans jamais inventer de valeur.

Relancer

Sans risque : /coach-setup ne pose que les questions sans réponse et ne remplace jamais une valeur existante. Pour changer un réglage déjà pris, dites-le en clair au coach (« passe en style factuel »), ou éditez config/workspace.user.toml.

Changer le staff

Modifier [agents].enabled met à jour ce que le coach considère joignable, mais n'installe ni ne retire les fichiers d'agents. Pour cela : ./install.sh --agents coach,nutritionist ou ./install.sh --no-medical.

En cas de doute

python3 scripts/coach_setup.py --status

Affiche le workspace détecté, les questions en attente, les fichiers installés et si votre configuration personnelle est bien exclue de git.