diff --git a/docs/i18n/README.de.md b/docs/i18n/README.de.md index ab6d570..cd02d34 100644 --- a/docs/i18n/README.de.md +++ b/docs/i18n/README.de.md @@ -65,7 +65,7 @@ mehrere Ordner — wechsle mit `cd` in den richtigen, und der Coach macht dort w du aufgehört hast. Danach sprichst du in natürlicher Sprache mit ihm; keine Konfigurationsdateien, keine Befehle zum Auswendiglernen. -### Einmalige Einrichtung (5 Minuten, 3 Schritte) +### Einmalige Einrichtung (Claude Code — 2 Befehle) **Noch nie Claude Code benutzt?** Installiere es zuerst: @@ -77,30 +77,24 @@ curl -fsSL https://claude.ai/install.sh | bash Du brauchst außerdem [`uv`](https://docs.astral.sh/uv/getting-started/installation/) — es holt sich die richtige Python-Version selbst, sonst ist nichts zu installieren. -**Schritt 1 — den Coach einstecken.** Einmalig in einem beliebigen Terminal ausführen: +**Installiere das Plugin.** Führe in Claude Code diese zwei Befehle einmalig aus: -```bash -claude mcp add performance-agent -s user -- uvx performance-agent ``` - -Das registriert das „Gehirn“ des Coaches (die Engine, die Wissenschaftsbibliothek, -dein zukünftiges Athletenprofil) als Werkzeug, das Claude Code aufrufen kann. -`-s user` macht es in jedem Ordner verfügbar, in dem du später `claude` startest — das -ist es, was ein Ordner pro Athlet funktionieren lässt. - -**Schritt 2 — ihm das Coaching beibringen.** Schritt 1 gab Claude die *Werkzeuge* (die -Mathematik, die Daten). Dieser Schritt gibt ihm die *Coaching-Protokolle* — was wann -zu fragen ist, wann man bei einem Ziel ehrlich sein muss, wie man ein Programm baut: - -```bash -git clone --depth 1 https://github.com/clementrx/Performance-agent -mkdir -p ~/.claude/skills -cp -R Performance-agent/skills/* ~/.claude/skills/ +/plugin marketplace add clementrx/Performance-agent +/plugin install performance-agent@performance-agent ``` -**Schritt 3 — Claude Code vollständig beenden und neu starten.** Ein neues Werkzeug -wird nur beim *Start* einer `claude`-Sitzung geladen: Schließe jede offene Sitzung -komplett und führe `claude` erneut aus. +Eine einzige Installation gibt dir beide Hälften des Coaches: die *Werkzeuge* (die +Engine, die Wissenschaftsbibliothek, dein zukünftiges Athletenprofil) als MCP-Server +**und** die *Coaching-Protokolle* — die 16 Skills, die Claude sagen, was wann zu fragen +ist, wann man bei einem Ziel ehrlich sein muss, wie man ein Programm baut. Der MCP-Server +registriert sich auf Benutzerebene, ist also in jedem Ordner verfügbar, in dem du später +`claude` startest — das ist es, was ein Ordner pro Athlet funktionieren lässt. Claude Code +hält das Plugin aktuell (`/plugin marketplace update performance-agent`). + +**Beende Claude Code vollständig und starte es neu.** Neue Werkzeuge und Skills werden +nur beim *Start* einer `claude`-Sitzung geladen: Schließe jede offene Sitzung komplett +und führe `claude` erneut aus. **Prüfen, ob es funktioniert hat** — öffne einen Athletenordner und frage: @@ -111,6 +105,12 @@ komplett und führe `claude` erneut aus. Du solltest 103 Werkzeuge sehen. Wenn ja, bist du fertig — leg einen Ordner an und fang an zu coachen. +> **Nicht auf Claude Code?** Cursor, Claude Desktop und andere MCP-Hosts haben kein +> Plugin-Format. Registriere den Server manuell mit `claude mcp add performance-agent +> -s user -- uvx performance-agent` (oder dem entsprechenden JSON in der MCP-Konfiguration +> deines Hosts) und kopiere dann die Coaching-Protokolle in die Anweisungen deines Hosts. +> Vollständige Schritte pro Client: [docs/installing.md](../installing.md). + > **Auf einem Host, der den Startordner nicht wählen kann?** Claude Desktop und einige > andere MCP-Hosts starten immer am selben Ort. Setze dort `PERFORMANCE_AGENT_HOME` in > der Server-Konfiguration auf den Athletenordner, statt mit `cd` hineinzuwechseln. diff --git a/docs/i18n/README.es.md b/docs/i18n/README.es.md index 8d0c691..36e77f5 100644 --- a/docs/i18n/README.es.md +++ b/docs/i18n/README.es.md @@ -64,7 +64,7 @@ Nada se envía a ninguna parte. Entrenar a varios atletas es solo tener varias c — haz `cd` a la correcta y el coach retoma donde lo dejaste. Luego le hablas en lenguaje natural; sin archivos de configuración, sin comandos que memorizar. -### Instalación única (5 minutos, 3 pasos) +### Instalación única (Claude Code — 2 comandos) **¿Nunca has usado Claude Code?** Instálalo primero: @@ -76,29 +76,23 @@ curl -fsSL https://claude.ai/install.sh | bash También necesitas [`uv`](https://docs.astral.sh/uv/getting-started/installation/) — descarga por sí solo la versión correcta de Python, nada más que instalar. -**Paso 1 — conectar el coach.** Ejecuta esto una sola vez, desde cualquier terminal: +**Instala el plugin.** Desde Claude Code, ejecuta estos dos comandos una sola vez: -```bash -claude mcp add performance-agent -s user -- uvx performance-agent ``` - -Esto registra el «cerebro» del coach (el motor, la biblioteca científica, tu futuro -perfil de atleta) como una herramienta que Claude Code puede invocar. `-s user` lo -hace disponible desde cualquier carpeta donde luego lances `claude` — que es lo que -hace funcionar lo de una carpeta por atleta. - -**Paso 2 — enseñarle a entrenar.** El paso 1 le dio a Claude las *herramientas* (las -matemáticas, los datos). Este paso le da los *protocolos de coaching* — qué preguntar -y cuándo, cuándo ser honesto con un objetivo, cómo construir un programa: - -```bash -git clone --depth 1 https://github.com/clementrx/Performance-agent -mkdir -p ~/.claude/skills -cp -R Performance-agent/skills/* ~/.claude/skills/ +/plugin marketplace add clementrx/Performance-agent +/plugin install performance-agent@performance-agent ``` -**Paso 3 — cierra Claude Code por completo y vuelve a abrirlo.** Una herramienta nueva -solo se carga cuando una sesión de `claude` *arranca*: cierra cualquier sesión abierta +Una sola instalación te da las dos mitades del coach: las *herramientas* (el motor, la +biblioteca científica, tu futuro perfil de atleta) como servidor MCP, **y** los +*protocolos de coaching* — los 16 skills que le dicen a Claude qué preguntar y cuándo, +cuándo ser honesto con un objetivo, cómo construir un programa. El servidor MCP se +registra a nivel de usuario, así que está disponible desde cualquier carpeta donde luego +lances `claude` — que es lo que hace funcionar lo de una carpeta por atleta. Claude Code +mantiene el plugin actualizado (`/plugin marketplace update performance-agent`). + +**Cierra Claude Code por completo y vuelve a abrirlo.** Las nuevas herramientas y skills +solo se cargan cuando una sesión de `claude` *arranca*: cierra cualquier sesión abierta y ejecuta `claude` de nuevo. **Comprueba que funcionó** — abre una carpeta de atleta y pregunta: @@ -110,6 +104,12 @@ y ejecuta `claude` de nuevo. Deberías ver 103 herramientas. Si es así, ya está — crea una carpeta y empieza a entrenar. +> **¿No usas Claude Code?** Cursor, Claude Desktop y otros hosts MCP no tienen formato de +> plugin. Registra el servidor a mano con `claude mcp add performance-agent -s user -- +> uvx performance-agent` (o el JSON equivalente en la configuración MCP de tu host), y +> luego copia los protocolos de coaching en las instrucciones de tu host. Pasos completos +> por cliente: [docs/installing.md](../installing.md). + > **¿En un host que no puede elegir la carpeta de lanzamiento?** Claude Desktop y algún > otro host MCP siempre arrancan en el mismo sitio. Ahí, define `PERFORMANCE_AGENT_HOME` > hacia la carpeta del atleta en la configuración del servidor en vez de hacer `cd`. diff --git a/docs/i18n/README.fr.md b/docs/i18n/README.fr.md index 55d4366..373c746 100644 --- a/docs/i18n/README.fr.md +++ b/docs/i18n/README.fr.md @@ -64,7 +64,7 @@ n'est envoyé ailleurs. Coacher plusieurs athlètes, c'est juste plusieurs dossi faites `cd` dans le bon et le coach reprend là où vous en étiez. Ensuite, vous lui parlez en langage naturel ; aucun fichier de configuration, aucune commande à mémoriser. -### Installation unique (5 minutes, 3 étapes) +### Installation unique (Claude Code — 2 commandes) **Jamais utilisé Claude Code ?** Installez-le d'abord : @@ -76,30 +76,24 @@ curl -fsSL https://claude.ai/install.sh | bash Il vous faut aussi [`uv`](https://docs.astral.sh/uv/getting-started/installation/) — il récupère tout seul la bonne version de Python, rien d'autre à installer. -**Étape 1 — brancher le coach.** À lancer une seule fois, depuis n'importe quel -terminal : +**Installez le plugin.** Depuis Claude Code, lancez ces deux commandes une seule fois : -```bash -claude mcp add performance-agent -s user -- uvx performance-agent ``` - -Cela enregistre le « cerveau » du coach (le moteur, la bibliothèque scientifique, -votre futur profil d'athlète) comme un outil que Claude Code peut appeler. `-s user` -le rend disponible depuis n'importe quel dossier où vous lancerez `claude` — c'est ce -qui fait fonctionner le principe d'un dossier par athlète. - -**Étape 2 — lui apprendre à coacher.** L'étape 1 donne à Claude les *outils* (les -maths, les données). Celle-ci lui donne les *protocoles de coaching* — quoi demander -et quand, quand être honnête sur un objectif, comment construire un programme : - -```bash -git clone --depth 1 https://github.com/clementrx/Performance-agent -mkdir -p ~/.claude/skills -cp -R Performance-agent/skills/* ~/.claude/skills/ +/plugin marketplace add clementrx/Performance-agent +/plugin install performance-agent@performance-agent ``` -**Étape 3 — quitter complètement et relancer Claude Code.** Un nouvel outil n'est -chargé qu'au *démarrage* d'une session `claude` : fermez toute session ouverte et +Une seule installation vous donne les deux moitiés du coach : les *outils* (le moteur, +la bibliothèque scientifique, votre futur profil d'athlète) sous forme de serveur MCP, +**et** les *protocoles de coaching* — les 16 skills qui indiquent à Claude quoi demander +et quand, quand être honnête sur un objectif, comment construire un programme. Le serveur +MCP s'enregistre au niveau utilisateur, donc il est disponible depuis n'importe quel +dossier où vous lancerez ensuite `claude` — c'est ce qui fait fonctionner le principe d'un +dossier par athlète. Claude Code garde le plugin à jour +(`/plugin marketplace update performance-agent`). + +**Quittez complètement et relancez Claude Code.** Les nouveaux outils et skills ne sont +chargés qu'au *démarrage* d'une session `claude` : fermez toute session ouverte et relancez `claude`. **Vérifiez que ça marche** — ouvrez un dossier d'athlète et demandez : @@ -111,6 +105,12 @@ relancez `claude`. Vous devez voir 103 outils. Si oui, c'est terminé — créez un dossier et commencez à coacher. +> **Pas sur Claude Code ?** Cursor, Claude Desktop et les autres hôtes MCP n'ont pas de +> format de plugin. Enregistrez le serveur à la main avec `claude mcp add +> performance-agent -s user -- uvx performance-agent` (ou le JSON équivalent dans la +> config MCP de votre hôte), puis copiez les protocoles de coaching dans les instructions +> de votre hôte. Étapes complètes par client : [docs/installing.md](../installing.md). + > **Sur un hôte qui ne peut pas choisir le dossier de lancement ?** Claude Desktop et > quelques autres hôtes MCP démarrent toujours au même endroit. Là, définissez > `PERFORMANCE_AGENT_HOME` vers le dossier de l'athlète dans la config du serveur au diff --git a/docs/i18n/README.it.md b/docs/i18n/README.it.md index 2241f49..8a0f6a3 100644 --- a/docs/i18n/README.it.md +++ b/docs/i18n/README.it.md @@ -64,7 +64,7 @@ Nulla viene inviato altrove. Allenare più atleti significa solo più cartelle in quella giusta e il coach riprende da dove avevi lasciato. Poi gli parli in linguaggio naturale; nessun file di configurazione, nessun comando da memorizzare. -### Installazione una tantum (5 minuti, 3 passi) +### Installazione una tantum (Claude Code — 2 comandi) **Mai usato Claude Code?** Installalo prima: @@ -76,30 +76,24 @@ curl -fsSL https://claude.ai/install.sh | bash Ti serve anche [`uv`](https://docs.astral.sh/uv/getting-started/installation/) — scarica da solo la versione giusta di Python, nient'altro da installare. -**Passo 1 — collegare il coach.** Esegui questo una sola volta, da qualsiasi terminale: +**Installa il plugin.** Da Claude Code, esegui questi due comandi una sola volta: -```bash -claude mcp add performance-agent -s user -- uvx performance-agent ``` - -Questo registra il «cervello» del coach (il motore, la biblioteca scientifica, il tuo -futuro profilo atleta) come strumento che Claude Code può richiamare. `-s user` lo -rende disponibile da qualsiasi cartella da cui avvierai `claude` — ed è ciò che fa -funzionare una cartella per atleta. - -**Passo 2 — insegnargli ad allenare.** Il passo 1 ha dato a Claude gli *strumenti* (la -matematica, i dati). Questo passo gli dà i *protocolli di coaching* — cosa chiedere e -quando, quando essere onesto su un obiettivo, come costruire un programma: - -```bash -git clone --depth 1 https://github.com/clementrx/Performance-agent -mkdir -p ~/.claude/skills -cp -R Performance-agent/skills/* ~/.claude/skills/ +/plugin marketplace add clementrx/Performance-agent +/plugin install performance-agent@performance-agent ``` -**Passo 3 — chiudi completamente Claude Code e riaprilo.** Un nuovo strumento viene -caricato solo all'*avvio* di una sessione `claude`: chiudi ogni sessione aperta ed -esegui di nuovo `claude`. +Una sola installazione ti dà entrambe le metà del coach: gli *strumenti* (il motore, la +biblioteca scientifica, il tuo futuro profilo atleta) come server MCP **e** i *protocolli +di coaching* — i 16 skill che dicono a Claude cosa chiedere e quando, quando essere onesto +su un obiettivo, come costruire un programma. Il server MCP si registra a livello utente, +quindi è disponibile da qualsiasi cartella da cui avvierai `claude` — ed è ciò che fa +funzionare una cartella per atleta. Claude Code tiene il plugin aggiornato +(`/plugin marketplace update performance-agent`). + +**Chiudi completamente Claude Code e riaprilo.** I nuovi strumenti e skill vengono +caricati solo all'*avvio* di una sessione `claude`: chiudi ogni sessione aperta ed esegui +di nuovo `claude`. **Verifica che abbia funzionato** — apri una cartella di atleta e chiedi: @@ -110,6 +104,12 @@ esegui di nuovo `claude`. Dovresti vedere 103 strumenti. Se sì, hai finito — crea una cartella e comincia ad allenare. +> **Non su Claude Code?** Cursor, Claude Desktop e altri host MCP non hanno un formato di +> plugin. Registra il server a mano con `claude mcp add performance-agent -s user -- uvx +> performance-agent` (o il JSON equivalente nella configurazione MCP del tuo host), poi +> copia i protocolli di coaching nelle istruzioni del tuo host. Passi completi per client: +> [docs/installing.md](../installing.md). + > **Su un host che non può scegliere la cartella di avvio?** Claude Desktop e qualche > altro host MCP partono sempre dallo stesso posto. Lì, imposta `PERFORMANCE_AGENT_HOME` > sulla cartella dell'atleta nella configurazione del server invece di fare `cd`.