Study Guide

Procédure :

1. Utiliser le tool Glob pour résoudre le chemin et lister les fichiers image
2. Utiliser le tool Read pour lire chaque image (Claude Code supporte la lecture d'images via Read)
3. Analyser les images lues et produire la fiche

L'utilisateur peut aussi fournir dans le prompt (optionnel) :

• La matière et le niveau (ex: "PC 4ème", "HG 3ème")
• La date d'un contrôle à venir
• La note visée (ex: "objectif 16", "objectif 20/20")

Si la matière n'est pas précisée, la déduire du contenu des photos.

Note visée — question obligatoire au démarrage

Avant de lancer l'analyse, si l'utilisateur n'a pas précisé la note qu'il vise, poser la question via AskUserQuestion :

« Quelle note Louis (ou le prénom déduit) vise-t-il sur ce contrôle ? » Options : 12-14 (moyenne correcte), 15-17 (bonne note), 18-20 (excellence), Je ne sais pas

La note visée conditionne la profondeur et le volume de la fiche :

Règle : une fiche « 20/20 » DOIT contenir au minimum une Section 8 « Annexes objectif 20/20 » et une Section 9 « Session 3 — Contrôle blanc ».

Pipeline d'analyse

Étape 1 — OCR & Extraction

Suis intégralement le prompt figé : ${CLAUDE_PROJECT_DIR}/backend/prompts/ocr/system.md (block_type, confidence, format JSON, règles d'extraction fidèle). C'est la source de vérité unique, partagée avec le backend Go (internal/infra/anthropic, internal/infra/openaicompat). Ne pas redupliquer ses règles ici — toute évolution stabilisée se fait dans ce fichier.

Étape 2 — Structuration en Items

Suis intégralement le prompt figé : ${CLAUDE_PROJECT_DIR}/backend/prompts/structuration/system.md (types KNOWLEDGE / PROCEDURE / DOCUMENT / WRITING, règles par type, regroupement en notions, format JSON, confidence). C'est la source de vérité unique partagée avec le backend Go. Ne pas redupliquer ses règles ici.

Les types d'items transverses ci-dessous sont propres au skill (prototype, pas encore figés dans le backend) et complètent ceux du prompt :

Types d'items transverses — OBLIGATOIRES

En plus des items extraits du cours, toujours générer ces items transverses s'ils sont pertinents à la matière :

Règle critique : une SHORT_LIST ne doit JAMAIS être noyée dans un grand tableau. Elle mérite sa propre carte mentale / encadré visuel dédié, car l'élève perdra des points s'il en oublie un élément.

Règle critique : les TRAP ont TOUJOURS un moyen mnémotechnique associé (ex: « séculier = dans le siècle, avec les gens » ; « Église majuscule = institution, église minuscule = bâtiment »).

Étape 3 — Génération de documents originaux

À partir des items extraits, créer de nouveaux documents inédits qui ne sont pas dans le cours original. Ces documents servent de supports d'exercice et renforcent le double codage (verbal + visuel).

3A — Tableaux de données

Générer des tableaux numériques originaux cohérents avec le cours mais contenant des valeurs différentes de celles du cahier. L'élève doit exploiter le tableau pour répondre.

Exemple (PC — masse volumique) :

| Matériau | Masse (g) | Volume (cm³) | ρ (g/cm³) |
|----------|-----------|--------------|-----------|
| Échantillon A | 135 | 50 | ? |
| Échantillon B | 78 | ? | 2.6 |
| Échantillon C | ? | 30 | 0.92 |

Règles :

• Les valeurs doivent être réalistes et cohérentes avec la matière
• Inclure 1-2 valeurs à calculer (?) pour les questions NUMERIC
• Varier les unités si pertinent (g/kg, cm³/L)
• Ajouter une colonne "Identifie le matériau" si le cours contient un tableau de référence

3B — Graphiques et courbes

Générer tous les graphiques en SVG inline. Ne jamais utiliser Mermaid.js (le layout automatique produit des résultats médiocres).

Exemple — Courbe SVG :

<svg viewBox="0 0 400 220" xmlns="http://www.w3.org/2000/svg" style="font-family: sans-serif;">
  <!-- Axes -->
  <line x1="50" y1="180" x2="370" y2="180" stroke="#333" stroke-width="1.5"/>
  <line x1="50" y1="180" x2="50" y2="20" stroke="#333" stroke-width="1.5"/>
  <!-- Courbe -->
  <polyline points="50,170 90,150 130,150 170,150 210,110 250,70 290,30 330,30 370,30"
            fill="none" stroke="#E85D4C" stroke-width="2.5" stroke-linecap="round"/>
  <!-- Graduation + labels axes -->
  <text x="200" y="210" text-anchor="middle" font-size="11">Temps (min)</text>
  <text x="15" y="100" font-size="11" transform="rotate(-90 15 100)">T (°C)</text>
</svg>

Exemple — Histogramme SVG :

<svg viewBox="0 0 400 200" xmlns="http://www.w3.org/2000/svg">
  <rect x="50" y="20" width="40" height="160" fill="#4A90D9" />
  <rect x="110" y="80" width="40" height="100" fill="#7CB342" />
  <rect x="170" y="40" width="40" height="140" fill="#FF7043" />
  <text x="60" y="195" font-size="10">Fer</text>
  <text x="115" y="195" font-size="10">Alu</text>
  <text x="175" y="195" font-size="10">Cuivre</text>
</svg>

Règles :

• Toujours SVG inline — jamais Mermaid, jamais ASCII art
• Toujours inclure des axes titrés avec unités
• Les données du graphique doivent être différentes de celles du cours (pas de recopie)
• Utiliser les couleurs du projet (coral, teal, gold) pour un rendu cohérent

3C — Schémas légendés

Générer tous les schémas en SVG inline (y compris organigrammes, flowcharts, hiérarchies).

Schéma de processus (SVG avec flèches) :

<svg viewBox="0 0 500 200" xmlns="http://www.w3.org/2000/svg" style="font-family: sans-serif;">
  <defs>
    <marker id="arr" viewBox="0 0 10 7" refX="10" refY="3.5" markerWidth="8" markerHeight="6" orient="auto-start-reverse">
      <polygon points="0 0, 10 3.5, 0 7" fill="#666"/>
    </marker>
  </defs>
  <rect x="20" y="80" width="120" height="40" rx="8" fill="#4A90D9" stroke="#3a78b8" stroke-width="2"/>
  <text x="80" y="105" text-anchor="middle" fill="white" font-size="12" font-weight="600">Eau liquide</text>
  <line x1="140" y1="90" x2="210" y2="90" stroke="#666" stroke-width="2" marker-end="url(#arr)"/>
  <text x="175" y="82" text-anchor="middle" font-size="9" fill="#888">100°C</text>
  <rect x="213" y="70" width="120" height="40" rx="8" fill="#FF7043" stroke="#e0603a" stroke-width="2"/>
  <text x="273" y="95" text-anchor="middle" fill="white" font-size="12" font-weight="600">Vapeur</text>
</svg>

Schéma spatial/anatomique (SVG) :

<svg viewBox="0 0 300 200" xmlns="http://www.w3.org/2000/svg">
  <ellipse cx="150" cy="100" rx="80" ry="50" fill="none" stroke="#333" stroke-width="2"/>
  <circle cx="120" cy="80" r="3" fill="red"/>
  <text x="40" y="80" font-size="9">1. ________</text>
  <line x1="43" y1="78" x2="117" y2="80" stroke="red" stroke-dasharray="3"/>
  <circle cx="180" cy="110" r="3" fill="blue"/>
  <text x="200" y="112" font-size="9">2. ________</text>
  <line x1="183" y1="110" x2="198" y2="112" stroke="blue" stroke-dasharray="3"/>
</svg>

Règles :

• Toujours SVG inline — jamais Mermaid (layout automatique = résultat moche)
• Les légendes laissées vides (________) deviennent des questions LABEL_COMPLETION
• Inclure numérotation des éléments pour référence dans les questions
• Les schémas doivent représenter un concept du cours mais avec un agencement/exemple différent de celui du cahier
• Utiliser des <marker> SVG pour les flèches dans les flowcharts
• Privilégier un layout horizontal (LR) pour les processus linéaires, vertical (TD) pour les hiérarchies

3D — Cartes et plans simplifiés

Générer des cartes schématiques en SVG pour les exercices de localisation (HG surtout) :

<svg viewBox="0 0 400 300" xmlns="http://www.w3.org/2000/svg">
  <!-- Contour simplifié -->
  <path d="M50,100 L100,50 L200,40 L300,80 L350,150 L300,250 L150,280 L50,200 Z"
        fill="#f5f5dc" stroke="#333" stroke-width="2"/>
  <!-- Zones à identifier -->
  <circle cx="120" cy="120" r="8" fill="red" opacity="0.6"/>
  <text x="130" y="125" font-size="10" font-weight="bold">A</text>
  <circle cx="250" cy="160" r="8" fill="blue" opacity="0.6"/>
  <text x="260" y="165" font-size="10" font-weight="bold">B</text>
  <!-- Légende -->
  <text x="50" y="295" font-size="9">A = ________ | B = ________</text>
</svg>

Règles :

• Simplifier au maximum — l'objectif est l'identification, pas la précision cartographique
• Utiliser des lettres/numéros pour les zones, pas les noms (ceux-ci sont à deviner)
• Cohérent avec les localisations du cours

3E — Mini-cartes mentales à trous (exercices progressifs)

Les mini-cartes de la Section 2 sont déclinées en 3 niveaux d'exercice pour les sessions. Chaque version est un SVG distinct.

Noeud vide (à compléter) — utiliser un style visuel distinct :

<rect x="..." y="..." width="115" height="32" rx="6" fill="#e0e0e0" stroke="#bbb" stroke-width="1" stroke-dasharray="4"/>
<text x="..." y="..." text-anchor="middle" fill="#999" font-size="11" font-style="italic">?</text>

Niveau 1 — MINDMAP_PARTIAL (Session 1, reconnaissance) :

• La structure complète est visible (noeud central + toutes les connexions)
• 2-3 feuilles sur 5-7 sont remplacées par ? (cases grises en pointillé)
• L'élève reconnaît les éléments manquants parmi ceux qu'il vient de lire
• Inclure un <details> avec les réponses sous le SVG

Niveau 2 — MINDMAP_RECALL (Session 2, rappel) :

• Seul le noeud central est affiché avec son label
• Toutes les feuilles sont vides et numérotées (1. ?, 2. ?, etc.)
• L'élève doit retrouver tous les éléments de mémoire
• Question formulée : « Quels sont les N éléments de [Notion] ? »
• Inclure un <details> avec les réponses sous le SVG

Niveau 3 — MINDMAP_REBUILD (Session 3, objectif 18-20, reconstruction totale) :

• Seul le thème du chapitre est affiché au centre
• Les branches (notions) ET les feuilles sont toutes vides
• L'élève reconstruit la carte entière sur papier puis vérifie
• SVG plus grand (~500x300) avec layout en étoile (4-6 branches)
• Inclure un <details> avec la carte complète sous le SVG

3F — Fiche-méthode « analyser un document » (OBLIGATOIRE si matière = HG/SVT/français/PC)

Toujours inclure un encadré méthode réutilisable :

📋 MÉTHODE — Analyser un document
1. NATURE : quel type ? (miniature, photo, gravure, carte, texte, graphique, tableau…)
   ⚠️ Piège fréquent : « illustration » est trop vague. Préciser : miniature, enluminure, fresque, photo, affiche…
2. DATE : siècle ou année précise si donnée
3. SOURCE : titre, auteur, lieu de conservation
4. IDÉE PRINCIPALE : ce que le document montre/dit en 1 phrase
5. DÉTAILS UTILES : éléments que je vais réutiliser pour répondre aux questions

Ces 2-3 points sont quasi gratuits et reviennent à chaque contrôle.

3G — Encadré « pièges & mnémotechniques » (OBLIGATOIRE si items TRAP détectés)

Pour chaque TRAP de l'étape 2, produire une ligne dans un encadré dédié :

⚠️ PIÈGES CLASSIQUES DU CHAPITRE
| Confusion | Distinction | Mnémo |
|---|---|---|
| église / Église | minuscule = bâtiment, majuscule = institution | « l'Église avec un grand É = la grande organisation » |
| séculier / régulier | séculier = dans le monde, régulier = dans un monastère | « séculier = dans le siècle, avec les gens » |
| châsse / vitrail | châsse = coffre à reliques, vitrail = fenêtre colorée | « la châsse chasse les impuretés autour des reliques » |

3H bis — Exercices complets d'analyse de document (OBLIGATOIRE si matière = HG/français)

Ne pas se contenter de poser 1-2 questions ponctuelles sur les documents. Créer au moins 3 exercices complets d'analyse de document qui simulent l'exercice-type du contrôle, un par nature de document :

1. Analyse d'un document texte (extrait de chronique, contrat, règlement, lettre…) — inédit mais réaliste.
2. Analyse d'un document iconographique : miniature, enluminure, peinture, gravure, dessin ou caricature selon la matière/époque (rare au Moyen Âge mais présent dès le XVIIIe en HG).
3. Analyse d'un document cartographique (carte, plan) ou statistique (tableau, graphique) selon le chapitre.

Chaque exercice suit un format strict :

• Présentation du document (nature réelle + source fictive réaliste)
• 5-7 questions qui suivent la méthode N-D-S-I-D (nature, date, source, idée principale, détails, interprétation)
• Corrigé modèle rédigé qui montre le niveau attendu à l'écrit (phrases complètes, citations entre guillemets, vocabulaire précis)
• Erreurs à éviter listées explicitement

C'est l'exercice qui rapporte le plus de points au contrôle en HG. Un élève qui maîtrise la méthode gagne 5-7 points gratuits à chaque contrôle.

3H — Schémas légendés à reproduire de mémoire (OBLIGATOIRE si VISUAL_VOCAB détecté)

Pour chaque item VISUAL_VOCAB, produire un schéma SVG légendé avec deux versions : une complète (référence) et une vide (à compléter en Session 2 via LABEL_COMPLETION). L'objectif est que l'élève puisse reproduire le schéma de mémoire, pas juste reconnaître les mots.

Exemple : le pèlerin de Saint-Jacques avec ses 4 attributs (chapeau à large bord, pèlerine, besace, bourdon) numérotés 1→4.

Règles globales de génération de documents

1. Originalité : les documents générés doivent être inédits, pas des copies du cahier. Utiliser des valeurs, exemples et contextes différents.
2. Pertinence : chaque document doit tester un item/notion identifié dans l'étape 2.
3. Autonomie : la fiche doit être utilisable sans les photos originales. Tous les documents nécessaires sont générés dans la fiche.
4. Variété de format : utiliser au minimum 2 formats différents (Mermaid + SVG, ou Markdown table + Mermaid) dans une fiche.
5. Au moins 3 documents générés par fiche si le cours contient des éléments visuels. Au moins 1 document même si le cours est purement textuel (un tableau de synthèse ou un schéma de processus).
6. Questions associées : chaque document généré doit être la base d'au moins 1 question dans les sessions.

Étape 3bis — Pondération selon la grille du contrôle

Leçon tirée d'un 13/20 : un plan peut couvrir tout le savoir et rater des points parce qu'il sous-estime la part « exercices sur documents » (qui pèse souvent 50-70% du barème en HG/SVT).

Règle de pondération :

1. Si l'utilisateur fournit un barème ou un type de contrôle (ex: « contrôle d'histoire », « DS de SVT »), estimer la répartition typique : ~40% savoir pur, ~60% exercices sur documents.
2. La proportion de questions dans les sessions DOIT refléter cette répartition. Pour un contrôle HG type : au moins 8 questions sur 15 exploitent les documents générés (Section 3) ou la fiche-méthode (3F).
3. Chaque SHORT_LIST identifiée → au moins 1 question de restitution exhaustive en Session 2 (format CLOZE_KEYWORDS ou réponse libre).
4. Chaque TRAP identifié → au moins 1 MISCONCEPTION.MCQ dont les distracteurs utilisent la confusion.
5. Chaque VISUAL_VOCAB → au moins 1 LABEL_COMPLETION sur le schéma de la section 3H.

Étape 4 — Assemblage de la fiche

Format de sortie

Produire un document Markdown structuré en 6 sections :

1. Résumé du cours
2. Notions clés & Carte mentale
3. Documents d'exercice générés (tableaux, graphiques, schémas, cartes — inédits)
4. Session 1 (J0 soir) — Découverte & Reconnaissance
5. Session 2 (J2 soir) — Consolidation & Rappel
6. Corrigé détaillé & Plan de révision

SECTION 1 — Résumé du cours

• Résumé synthétique du cours en 5-10 bullet points
• Chaque bullet point = 1 notion clé
• Vocabulaire important en gras
• Formules encadrées en blocs de code

SECTION 2 — Notions clés & Mini-cartes mentales

Principe : au lieu d'une seule mindmap géante, générer une mini-carte SVG par notion (3-7 éléments max par carte). Cela respecte le chunking cognitif (mémoire de travail = 3-7 éléments) et permet leur réutilisation comme exercices dans les sessions.

Format des mini-cartes

Chaque mini-carte est un SVG inline avec :

• 1 noeud central (coral #E85D4C, rx arrondi, texte blanc gras) = le nom de la notion
• 3-7 noeuds feuilles (gold #F5C542, texte sombre) = les éléments clés à retenir
• Connexions en courbes bézier (<path> avec Q) légères (gris #ccc)
• Layout radial simple : feuilles réparties autour du centre (haut/bas, gauche/droite)
• viewBox compact (~380x200) pour tenir dans une grille 2 colonnes sur mobile

<svg viewBox="0 0 380 200" xmlns="http://www.w3.org/2000/svg" style="width:100%;font-family:system-ui,sans-serif">
  <!-- Noeud central -->
  <rect x="120" y="75" width="140" height="44" rx="22" fill="#E85D4C"/>
  <text x="190" y="102" text-anchor="middle" fill="#fff" font-weight="700" font-size="12">[Notion]</text>
  <!-- Feuille (répéter pour chaque élément) -->
  <path d="M120,97 Q80,97 60,55" stroke="#ccc" stroke-width="1.5" fill="none"/>
  <rect x="2" y="35" width="115" height="32" rx="6" fill="#F5C542"/>
  <text x="59" y="56" text-anchor="middle" fill="#1b1b1b" font-size="10">[Élément]</text>
</svg>

Mise en page

Afficher les mini-cartes en grille 2 colonnes (1 colonne sur mobile < 600px). Chaque carte dans un conteneur avec bordure gauche teal, fond blanc, ombre légère.

Pour chaque Notion, ajouter sous la carte :

### 📌 [Nom de la Notion]
- **Items** : liste des items rattachés
- **Mots-clés** : termes essentiels à retenir
- **Liens** : connexions avec d'autres notions du cours
- **A retenir** : 2-3 points essentiels de la notion, formulés comme des phrases courtes que l'élève peut se répéter (ex: « Les foires de Champagne attirent des marchands de toute l'Europe »)

Chaque noeud feuille de la mini-carte SVG doit correspondre à un item listé dans le bloc texte sous la carte. L'élève peut ainsi aller-retour entre le visuel (carte) et le détail (texte) pour ancrer sa compréhension.

Reproduire les tableaux du cours en Markdown. Décrire les schémas avec suffisamment de détail pour générer des exercices.

Règle de réutilisation

Les mini-cartes de la Section 2 servent de référence. Elles sont réutilisées en versions dégradées dans les sessions (voir MINDMAP_PARTIAL et MINDMAP_RECALL).

SECTION 3 — Documents d'exercice générés

Cette section contient les documents originaux inédits créés à l'étape 3 du pipeline. Ils servent de supports aux questions des sessions 4 et 5.

Présenter chaque document avec :

#### Document [lettre] — [Type] : [Titre descriptif]
[Le document : tableau Markdown, bloc Mermaid, ou SVG inline]

> Ce document est utilisé dans les questions : Q3, Q7, Q12, Q21

Inclure obligatoirement :

• Au moins 1 tableau de données avec valeurs à calculer
• Au moins 1 schéma ou graphique (Mermaid ou SVG)
• 1 document supplémentaire adapté à la matière (carte SVG en HG, diagramme Mermaid en SVT, courbe en PC, etc.)

Les documents doivent utiliser des valeurs et contextes originaux — jamais une copie du cahier.

SECTION 4 — Session 1 (J0 soir) : Découverte & Reconnaissance

Objectif mastery : UNKNOWN → FRAGILE (score ≥ 0.7 requis) Durée estimée : 15 minutes Difficulté : Niveau 1 uniquement (reconnaissance)

Générer 15 questions en respectant ces règles :

Types de questions autorisés (difficulté 1) :

1. QCM (FLASH_MCQ) — 4 options, 1 seule correcte, distracteurs plausibles
2. Vrai/Faux avec justification
3. Définition courte (DEF_SHORT) — "Qu'est-ce que [terme] ?"
4. Observation simple (DOC.DESCRIBE) — "Que représente ce schéma/tableau ?"
5. Lecture de valeur (DOC.READ_VALUE) — "D'après le tableau, quelle est la valeur de X ?"
6. Mini-carte à trous (MINDMAP_PARTIAL) — mini-carte SVG de la Section 2 avec 2-3 feuilles remplacées par ?. L'élève identifie les éléments manquants. 1-2 questions de ce type par session max.

Contraintes de composition :

• Variété : ne jamais enchaîner plus de 2 questions du même type
• Couverture : chaque Notion doit avoir au moins 1 question
• Anti-monotonie : alterner les notions (pas plus de 3 questions consécutives sur la même notion)
• Documents générés : au moins 3-4 questions doivent s'appuyer sur les documents de la Section 3 (tableaux, graphiques, schémas, cartes)
• Progression : commencer par les items les plus simples (vocabulaire), finir par les plus complexes

Format par question :

**Q[n] — [Type]** | Notion : [nom]
[Énoncé de la question]

Si QCM :
- A) ...
- B) ...
- C) ...
- D) ...

SECTION 5 — Session 2 (J2 soir) : Consolidation & Rappel

Objectif mastery : FRAGILE → OK (score ≥ 0.7 requis, sur items réussis en Session 1) Durée estimée : 15 minutes Difficulté : Niveaux 1-2 (reconnaissance + rappel aidé)

Générer 15 questions en respectant ces règles :

Types de questions autorisés (difficulté 1-2) :

1. QCM à piège (MISCONCEPTION.MCQ) — distracteurs basés sur les erreurs fréquentes
2. Texte à trous (CLOZE_KEYWORDS) — compléter avec les mots-clés
3. Association (ASSOC_TERM_DEF) — relier termes et définitions
4. Réponse courte — rappel libre sans options
5. Extraction d'information (DOC.EXTRACT_EVIDENCE) — "Quel élément du document montre que..."
6. Interprétation de tendance (DOC.INTERPRET_TREND) — "Comment évolue X d'après le graphique ?"
7. Légende à compléter (LABEL_COMPLETION) — remplir les légendes manquantes d'un schéma
8. Valeur numérique + unité (NUMERIC) — "Calculer X. Donner la valeur et l'unité."
9. Mini-carte rappel (MINDMAP_RECALL) — mini-carte SVG avec seulement le noeud central visible, toutes les feuilles vides et numérotées. L'élève reconstruit de mémoire. 1-2 questions de ce type par session max.

Composition 70/20/10 :

• 70% (≈10-11 questions) : items urgents — ceux qui étaient FRAGILE après Session 1, en priorité ceux échoués
• 20% (≈3 questions) : consolidation — items réussis en Session 1, reformulés différemment
• 10% (≈1 question) : découverte — un angle nouveau sur un item déjà vu (question plus ouverte)

Contraintes supplémentaires :

• Pas de répétition : ne jamais reposer la même question qu'en Session 1 (reformuler)
• Montée en difficulté : les items réussis en S1 passent en difficulté 2
• Items échoués : reproposés en difficulté 1 avec formulation différente
• Interleaving : alterner les notions systématiquement

SECTION 6 — Corrigé détaillé & Plan de révision

5A — Corrigé (pour chaque question des 2 sessions)

Format obligatoire en 3 composantes (conforme Z4-AC09) :

**Q[n] — Corrigé**
✅ **Réponse attendue** : [la bonne réponse complète]
🔍 **Ce qui manque souvent** : [erreur type ou piège fréquent sur cette question]
💡 **Astuce mnémonique** : [phrase, acronyme, ou image mentale pour retenir]

5B — Plan de révision calendaire

📅 PLAN DE RÉVISION

┌─────────────────────────────────────────────────┐
│ J0 (aujourd'hui soir) — SESSION 1               │
│ Objectif : Découvrir → FRAGILE                  │
│ Durée : ~15 min                                 │
│ Seuil : ≥ 70% de bonnes réponses               │
│ Si < 70% : refaire les questions échouées       │
│ avant de passer à Session 2                     │
├─────────────────────────────────────────────────┤
│ J1 (demain) — REPOS ACTIF                       │
│ Relire le résumé (Section 1) — 5 min max        │
│ Pas de questions : laisser le cerveau consolider │
├─────────────────────────────────────────────────┤
│ J2 (après-demain soir) — SESSION 2              │
│ Objectif : Consolider → OK                      │
│ Durée : ~15 min                                 │
│ Seuil : ≥ 70% de bonnes réponses               │
│ Si réussi : les items passent en état OK         │
│ Prochaine révision dans 3 jours (J5)            │
└─────────────────────────────────────────────────┘

Si une date de contrôle est fournie :

• Adapter les intervalles (compression des espacements)
• Ajouter une Session 3 optionnelle la veille du contrôle (5 questions flash, difficulté 2-3 sur les items encore FRAGILE)

5C — Tableau de progression mastery attendue

Générer un tableau par item :

| Item | Type | Notion | Après S1 | Après S2 | Prochaine révision |
|------|------|--------|----------|----------|--------------------|
| Masse volumique (def) | KNOWLEDGE | Densité | FRAGILE | OK | J+5 |
| Calcul de ρ | PROCEDURE | Densité | FRAGILE | OK | J+5 |
| ...  | ... | ... | ... | ... | ... |

Règles pédagogiques strictes

Scoring

• QCM : 1.0 (correct) ou 0.0 (incorrect) — pas de demi-point
• Mots-clés/Trous : 1.0 si tous les mots-clés, 0.5 si N-1, 0.0 sinon
• Réponse courte/Numérique : rubrique à 4 niveaux (0.0, 0.5, 0.7, 1.0)
• Seuil de transition : score ≥ 0.7 pour progresser

Anti-frustration

• Si un item semble trop dur (3 échecs consécutifs potentiels), proposer un indice dans la question
• Formulation bienveillante : "C'est normal de ne pas tout retenir du premier coup"
• Progression non-linéaire acceptée : certains items peuvent rester FRAGILE après S2

Calibration 85%

• Viser un taux de réussite attendu de 70-85% par session
• Session 1 : questions faciles (reconnaissance) → taux attendu ~80%
• Session 2 : questions plus exigeantes mais sur du déjà vu → taux attendu ~75%

Double codage

• Générer des documents visuels originaux (tableaux, graphiques, schémas, cartes) — ne pas se limiter à reproduire ceux du cours
• Les documents générés doivent utiliser des données et contextes inédits tout en testant les mêmes notions
• Formats disponibles : Markdown tables, Mermaid (xychart-beta, flowchart, mindmap, pie), SVG inline, ASCII art
• Chaque session doit contenir des questions exploitant au moins 2 documents différents de la Section 3

Interleaving

• En Session 2, ne jamais poser plus de 3 questions consécutives sur la même notion
• Alterner les types de questions pour maintenir l'attention

Exemple d'invocation

/study-guide ~/Documents/photos-cahier/pc-masse-volumique/
Matière : Physique-Chimie, 4ème
Contrôle dans 5 jours

Ou avec des fichiers spécifiques :

/study-guide ~/cahier/page1.jpg ~/cahier/page2.jpg

Ou avec un glob :

/study-guide ~/cahier/*.jpg

Contraintes techniques

• Le skill reçoit un chemin en $ARGUMENTS, résout les fichiers image via Glob, puis les lit via Read (capacité multimodale de Claude Code)
• Documents générés : utiliser Markdown tables, Mermaid, SVG inline et ASCII art pour créer des supports visuels originaux intégrés dans la fiche
• La fiche doit être autonome : utilisable sans les photos originales grâce aux documents générés
• SVG inline pour les schémas spatiaux, cartes, anatomie, circuits
• Mermaid pour les graphiques à axes, flowcharts, mind maps, diagrammes de classification
• Pas d'emoji dans le contenu sauf dans le corrigé (✅🔍💡) et le plan (📅📌)

Génération HTML obligatoire

La fiche doit être générée sous forme d'un fichier HTML autonome (fiche-revision.html) dans le même dossier que les images source. Ce fichier est la sortie principale du skill.

Caractéristiques du HTML

1. Fichier auto-suffisant : un seul .html, pas de fichiers externes
2. Photos du cahier embarquées en base64 : encoder chaque image source en data:image/jpeg;base64,... via un script shell (base64 -i) et les intégrer directement dans le HTML comme <img> dans une grille photo avec lightbox au clic
3. SVG inline : les schémas SVG sont directement dans le HTML (pas de fichier externe)
4. Mermaid.js via CDN : charger https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js et utiliser des balises <pre class="mermaid"> pour le rendu côté client
5. CSS intégré : design moderne avec les couleurs du projet (coral #E85D4C, teal #1A4D4D, gold #F5C542, cream #FBF8F3)
6. Sommaire cliquable avec ancres id sur chaque section
7. Sections visuellement distinctes : bordures colorées par type (session 1 = bleu, session 2 = or, corrigés = vert, documents = coral)
8. Corrigés dans des balises <details> : repliables par défaut pour que l'élève ne voie pas les réponses
9. Responsive mobile-first : la fiche doit être lisible et confortable sur téléphone (portrait ET paysage) et sur tablette. Règles minimales :
   • <meta name="viewport" content="width=device-width,initial-scale=1"> dans <head>.
   • Breakpoints obligatoires :
     • @media (max-width: 768px) : padding wrap réduit (12px), header padding 16px, h1 à 20px, grille photos 2 colonnes, SVG max-height:260px, tableaux dans un wrapper overflow-x:auto pour scroller horizontalement.
     • @media (max-width: 480px) : grille photos 2 colonnes serrées, boutons print repositionnés en bas (barre fixe bottom:0; left:0; right:0) avec flex:1 chacun pour occuper toute la largeur, zones cliquables ≥ 44px.
     • @media (orientation: landscape) and (max-height: 500px) : header compacté (padding 10px, h1 18px), sommaire replié, photos en 4 colonnes, boutons print en haut droite mais plus petits.
   • Tableaux : chaque <table> doit être enveloppé dans un <div class="table-wrap"> avec overflow-x:auto, bord arrondi et indicateur visuel de scroll (box-shadow latéral ou mask-image gradient) qui disparaît en fin de scroll. Les cellules doivent garder pour que le texte se wrappe naturellement.

Procédure de génération

1. Produire d'abord le contenu de la fiche (analyse, questions, corrigés) dans la conversation
2. Générer le HTML complet via un script Bash qui :
   • Encode les images en base64 (base64 -i <fichier>)
   • Injecte les images dans le template HTML via heredoc
   • Écrit le fichier fiche-revision.html dans le dossier source
3. Ouvrir le fichier dans le navigateur avec open <fichier>

Structure HTML type

<!DOCTYPE html>
<html lang="fr">
<head>
  <meta charset="UTF-8">
  <title>Fiche de Révision — [Sujet]</title>
  <script src="https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js"></script>
  <style>/* CSS intégré */</style>
</head>
<body>
  <div class="header"><!-- Titre, matière, méta --></div>
  <div class="toc"><!-- Sommaire cliquable --></div>
  <div class="section photos"><!-- Photos base64 en grille --></div>
  <div class="section"><!-- Résumé --></div>
  <div class="section"><!-- Notions + Mermaid mindmap --></div>
  <div class="section documents"><!-- Documents générés (SVG, Mermaid, tables) --></div>
  <div class="section session1"><!-- Questions S1 --></div>
  <div class="section session2"><!-- Questions S2 --></div>
  <div class="section corriges"><!-- Corrigés dans <details> --></div>
  <div class="section"><!-- Plan de révision + tableau mastery --></div>
  <div class="lightbox"><!-- Lightbox pour photos --></div>
  <script>mermaid.initialize({startOnLoad:true, theme:'default'});</script>
</body>
</html>

📝 Rapport d'exécution (auto-amélioration)

Avant de terminer, complète le dernier rapport créé par le hook dans .claude/reports/study-guide/ (le fichier .md le plus récent avec status: pending).

Utilise le template .claude/report-template.md et remplis :

1. Input : résumé de la demande utilisateur (1-2 phrases)
2. Output : résumé de ce qui a été produit (1-2 phrases)
3. Scores (note chaque dimension de 1 à 5) :
   • Complétude : le skill a-t-il couvert tout ce qui était demandé ?
   • Précision : les outputs étaient-ils corrects et utiles ?
   • Efficacité : combien d'allers-retours avant un résultat satisfaisant ?
   • Robustesse : le skill a-t-il bien géré les cas limites rencontrés ?
4. Observations : points forts, points faibles, frictions utilisateur
5. Met à jour le status dans le frontmatter : success, partial, ou error

Si le fichier .claude/reports/study-guide/.review-ready existe, signale à l'utilisateur :

"Le skill /study-guide a été exécuté 5+ fois depuis le dernier review. Lancer /auto-review study-guide pour analyser et proposer des améliorations."