agentleFS
StephaneBayleStephaneBayle/coach-rugby/CLAUDE.md

coach-rugby

CLAUDE.md0 starsChanged 39 days agoMITView on GitHub

Ce fichier fait foi pour tout agent qui travaille dans ce dépôt. Ne réutiliser ni la structure, ni le vocabulaire, ni les skills d'autres projets chargés par un CLAUDE.md parent. Le seul modèle d'architecture est ~/Developer/plugin-wargame, dont on reprend les patterns, jamais le vocabulaire (wargame, client, prospect…). - plugin/ : le plugin livré, vers lequel pointe la marketplace. Il contient skills, agents, hooks, scripts, schémas, références, gabarits, bibliothèque d'exercices, exemples 100 % fictifs et évals. - La racine sert au…

  • In this repositoryOne other file it gives its agents.

The file

Files
CLAUDE.md

coach-rugby — règles du moteur

Ce fichier fait foi pour tout agent qui travaille dans ce dépôt.

Page blanche

Ne réutiliser ni la structure, ni le vocabulaire, ni les skills d'autres projets chargés par un CLAUDE.md parent. Le seul modèle d'architecture est ~/Developer/plugin-wargame, dont on reprend les patterns, jamais le vocabulaire (wargame, client, prospect…).

Ce que contient le dépôt

  • plugin/ : le plugin livré, vers lequel pointe la marketplace. Il contient skills, agents, hooks, scripts, schémas, références, gabarits, bibliothèque d'exercices, exemples 100 % fictifs et évals.
  • La racine sert au développement : ce fichier, tests/, docs/, la CI, la marketplace.

Ce CLAUDE.md n'est pas chargé quand le plugin est utilisé. Les règles qui doivent s'appliquer à l'usage vivent dans les skills et dans plugin/references/regles-d-usage.md.

Public

Des coachs et éducateurs de rugby amateur, souvent bénévoles et peu techniciens. D'abord les clubs, ensuite des structures hors club (pôles, sections sportives, sport-études, centres de formation, sélections). Les réponses du plugin sont simples, courtes et sans jargon technique.

Confidentialité (non négociable)

  • Les données des coachs vivent dans le dossier saison, hors du dépôt (userConfig.dossier_saison, par défaut ~/Rugby-Saisons).
  • On ne désigne jamais un joueur par son nom : des nombres (« 14 enfants ») ou des codes locaux (J01…).
  • Aucun nom, aucune date de naissance, aucun numéro de licence, téléphone, e-mail ou information de santé d'un joueur dans le code, les exemples, les commits, les issues, les PR ou les releases.
  • Tout nom de joueur qui apparaît dans une conversation va dans <dossier saison>/.joueurs-proteges.txt.
  • La garde garde-rgpd (hook) et le job CI donnees-personnelles bloquent les fuites. Ne jamais les contourner.
  • Les exemples sont 100 % fictifs ; le nom de test est « Zébulon Testard ».
  • Une donnée de test volontairement fictive qui ressemble à une donnée personnelle (téléphone, date de naissance…) porte le marqueur rgpd:fictif sur sa ligne, ou est assemblée par concaténation dans les tests. N'utiliser ce marqueur que pour des données inventées.

Santé et sécurité

  • Aucun avis médical, aucun diagnostic, aucune durée de retour au jeu prescrite. En cas de choc ou de blessure : rappel du protocole commotion et renvoi vers un professionnel de santé (plugin/references/protocole-commotion.md).
  • Les contenus pour les jeunes respectent la catégorie : le contact ne dépasse jamais le contact_max de la catégorie la plus jeune du groupe.

Sources

  • Les règles de la FFR changent chaque saison : ce sont des paramètres datés (plugin/references/categories.yaml), au statut a-verifier tant qu'un mainteneur ne les a pas confirmés avec une source datée. Jamais de valeur réglementaire codée en dur dans le code ou dans un skill.
  • Toute affirmation réglementaire ou scientifique renvoie à une entrée de plugin/references/sources.yaml. Ce qui n'est pas sourcé est une hypothèse, marquée comme telle jusque dans les fiches.
  • Documents FFR, World Rugby et formation.ffr.fr : résumer et renvoyer (lien et date), ne jamais reproduire de texte, de schéma ni de PDF.
  • Mon Coach Assistant (FFR) : passerelles par copier-coller seulement. Jamais d'identifiants, jamais d'automatisation de navigateur.

Licences

Code sous MIT, contenus pédagogiques sous CC BY-SA 4.0 : voir LICENCES.md.

Technique

  • Le Markdown d'abord. Chaque skill fonctionne sans Node (chemin B, décrit dans plugin/references/outillage.md). Les scripts Node accélèrent et fiabilisent (chemin A), et tournent en CI.
  • Jamais de dossier bin/ à la racine du plugin : Cowork et claude.ai refuseraient alors tout le plugin. La CLI est plugin/scripts/coach-rugby.mjs.
  • Les hooks (garde-rgpd.mjs, session-start.mjs) n'importent que des modules node:*, pour fonctionner même sans dépendances installées.
  • ${CLAUDE_PLUGIN_ROOT} et ${CLAUDE_PLUGIN_DATA} ne sont pas exportés au Bash lancé par Claude : les écrire en clair dans les SKILL.md, où ils sont substitués au chargement.
  • Node 20 ou plus. Données en YAML, validées par JSON Schema 2020-12 (Ajv).
  • Les fiches générées se régénèrent, elles ne se retouchent pas.
  • Les tests ne touchent jamais le vrai dossier saison : tests/environnement.mjs impose un COACH_RUGBY_DOSSIER temporaire.
  • Projet hors iCloud.

Avant toute PR : npm test et npm run valider doivent passer.

Évals

claude plugin eval se lance en local uniquement (npm run evals), jamais en CI : aucune clé d'API sur GitHub. Il faut Claude Code 2.1.295 ou plus (les versions antérieures répondent « currently in early access ») et une session connectée (claude auth login). Le message « early access » vient d'une version trop ancienne, pas du compte. Le script lance un essai par cas avec un plafond de 3 $ ; les résultats sont consignés dans docs/evals/resultats.md. Écrire la date du jour dans le texte du prompt : EVAL_COACH_RUGBY_AUJOURDHUI n'agit que sur les commandes du plugin.

Git

  • Une branche par sujet, lot-<n>/<sujet>, et une PR par branche, avec la checklist du modèle de PR.
  • Commits et PR en français, avec la ligne Co-Authored-By.
  • Versions 0.<lot>.0 à la clôture de chaque lot ; CHANGELOG.md rédigé pour des coachs, pas pour des développeurs.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.