# claude-math Plugin Claude Code pour le cours **Mathématiques pour la cryptographie** (M1 Cybersécurité, A. Roux-Langlois). Il regroupe ce qui était jusque-là dans le `.claude/` du dossier de cours : | Composant | Chemin | Rôle | |---|---|---| | Skill | `skills/math-exercises/SKILL.md` | Génère des séries de 4 exercices progressifs sur le prochain sujet non maîtrisé, corrige les réponses, et tient à jour `PROGRESS.md` / `REVISIONS.md`. | | Commande | `commands/exos.md` | `/exos` — lance le skill en forçant Opus via son frontmatter `model:`. | | Hook | `hooks/verify-calculations.sh` | `UserPromptSubmit` : vérifie automatiquement toute affirmation mathématique tapée dans un message et renvoie un verdict ✅/❌ ligne par ligne. | ## Installation ```bash /plugin marketplace add ssh://forgejo@zospace.freeboxos.fr/zo/claude-math /plugin install claude-math@claude-math ``` Le dépôt est à la fois le plugin (`.claude-plugin/plugin.json`) et une marketplace à entrée unique (`.claude-plugin/marketplace.json`), donc les deux commandes suffisent. ## Ce que le skill attend du projet où il tourne Le plugin ne transporte **pas** les données du cours. Dans le dossier de travail, il s'attend à trouver : - `CLAUDE.md` — le plan du cours (TD1/TD2/TD3 et leurs sous-sections) ; c'est la source de la liste des sujets ; - `NOTATIONS_REFERENCE.md` — les notations telles qu'elles apparaissent en cours ; - `PROGRESS.md` — suivi par sujet (créé par le skill s'il manque) ; - `REVISIONS.md` — notions non réussies du premier coup, pour re-test espacé (créé par le skill s'il manque) ; - les PDF des TD et de leurs corrections, pour calibrer notation et difficulté. ## Le hook de vérification À chaque message, le hook extrait les énoncés vérifiables et les contrôle : - chaînes d'égalités et de congruences — `8^6 mod 15 = 64*8^4 = … = 4` ; - divisibilité — `7 | 28` ; - primalité — `13 est premier` ; - `pgcd` / `ppcm` / `φ(n)` ; - équations à une inconnue — `2x + 3 = 7`. **Règle de portée du modulus :** un `mod N` écrit sur *n'importe quel* maillon d'une chaîne porte sur **tous** les maillons. C'est la convention du cours : le modulus est énoncé une fois et reste implicite ensuite. Si deux moduli différents apparaissent dans la même chaîne, le hook se tait plutôt que d'accuser à tort. Notations acceptées : exposants Unicode (`4²²`), `≡`, `(mod 15)`, `φ`, `×`, `·`, `pgcd`/`ppcm`, et le LaTeX courant (`$…$`, `\equiv`, `\pmod{15}`, `8^{6}`). Les maths noyées dans de la prose française sont extraites et vérifiées ligne par ligne. ### Dépendance Le script lance Python avec **sympy** via `nix-shell -p python3 python3Packages.sympy` — il suppose donc **NixOS** (ou Nix installé). Sur une machine sans Nix, remplacer cette ligne de `hooks/verify-calculations.sh` par un `python3` disposant de sympy. Sans dépendance disponible, le hook échoue silencieusement et ne bloque jamais l'envoi d'un message. ## Développement Le hook est un script bash qui encapsule un programme Python en heredoc. Pour le tester sans passer par Claude Code, lui envoyer sur stdin le JSON de l'évènement : ```bash printf '{"prompt": "8^6 mod 15 = 64 * 8^4 = 4"}' | bash hooks/verify-calculations.sh ``` Il répond sur stdout un JSON `{"systemMessage": …}` contenant les verdicts, et les écrit en direct sur `/dev/tty` quand un terminal est disponible.