Page d'apprentissage sans douleur

Transformez vos supports d'apprentissage en une page web par matière, permettant à l'utilisateur de progresser dans l'ordre, de vérifier sa compréhension et de s'assurer qu'il a bien acquis les connaissances. Une matière est un projet à long terme : vous pouvez ajouter de nouveaux supports chaque semaine ; pendant les révisions, ouvrez les sections liées à l'examen dans la même page. Lorsque l'utilisateur n'a pas de supports, commencez par l'aider à planifier son parcours d'apprentissage et à trouver des ressources fiables, puis créez la page.

Zéro. Configuration de l'environnement (adaptation à différents agents IA)

Cette compétence a été initialement écrite pour Claude. Voici comment l'adapter à d'autres agents comme Codex, WorkBuddy, etc. Suivez les règles du corps du texte ; en cas de différence de capacité, appliquez les règles ci-dessous.

Lecture de fichiers : utilisez les outils de fichier ou les scripts à votre disposition pour lire le dossier fourni par l'utilisateur (PDF, PPT, DOCX, images). Si vous ne pouvez pas faire d'OCR, indiquez à l'utilisateur quelles pages n'ont pas été lues.
Connexion Internet : lorsque vous disposez d'un outil de recherche, utilisez-le pour la planification à partir de zéro et la vérification des faits ; dans le cas contraire, indiquez-le et demandez à l'utilisateur de fournir les supports.
Questions : lorsque vous devez poser des questions à l'utilisateur, faites-le en une seule fois ; si un outil de questions à choix existe, utilisez-le.
Emplacement de la page web : par défaut, écrivez dans le dossier du cours _page_apprentissage/ (si le dossier n'existe pas, créez <nom_du_cours>_page_apprentissage/ dans le répertoire de travail actuel) : index.html est la page entière (fichier unique, données intégrées, ouvrable directement dans le navigateur) ; data/course.json est le fichier de données original ; img/ contient les captures d'écran des sources. Si vous pouvez publier la page hébergée, vous pouvez en publier une autre copie, mais le dossier local reste l'original.
La page ne peut pas appeler l'IA : partout où le texte dit "Demandez à Claude d'organiser dans la page web / d'utiliser les capacités sample, db, assets", remplacez par un stockage dans localStorage et fournissez un bouton "Tout copier (pour l'IA)", permettant à l'utilisateur de vous renvoyer le contenu pour que vous l'organisiez.
Validation : lorsque vous pouvez exécuter Python, exécutez python3 scripts/validate_course.py <chemin>/data/course.json jusqu'à ce qu'il n'y ait plus d'erreurs ; lorsque vous pouvez utiliser un navigateur ou un navigateur sans tête, ouvrez index.html pour vérifier le rendu et les interactions ; pour les vérifications que vous ne pouvez pas effectuer, informez-en l'utilisateur.

I. Définir les spécifications

Commencez par déterminer la catégorie à partir des dires et des supports de l'utilisateur. Si vous ne pouvez pas déterminer, posez une seule question (au maximum 3 questions) pour clarifier. Si l'utilisateur n'est pas présent, choisissez la catégorie la plus raisonnable et expliquez dans la livraison laquelle et pourquoi.

Type	Situation typique	Objectif	Points clés
Auto-apprentissage compréhension	Uniquement manuels, transcriptions de cours en ligne, articles ; pas pour un examen	Comprendre et apprendre correctement	Expliquer clairement et correctement ; vérifier avec des questions de compréhension ; pas d'analyse des examens, pas de chronométrage
Initiation légère	Ne connaît pas un concept ou un petit sujet, veut une initiation rapide ; temps d'apprentissage total estimé à moins de 3 heures	Établir rapidement une compréhension correcte	Pas de parcours, pas d'attente de confirmation ; définir soi-même le parcours puis générer directement la page (voir IV-3)
Auto-apprentissage · Planification de zéro	Ne sait que ce qu'il veut apprendre, n'a pas de supports	Apprendre du plus simple au plus complexe	D'abord rechercher, planifier le parcours, trouver des cours et manuels de référence, demander à l'utilisateur de confirmer le parcours, puis créer la page ; l'explication doit être progressive (voir IV-2)
Suivi de cours	Pendant le semestre, reçoit des diapositives et des transcriptions de cours chaque semaine ou toutes les deux semaines	Suivre le cours, comprendre le contenu hebdomadaire	Mises à jour incrémentielles ; progression par semaine ; alignement strict avec le périmètre du cours
Révision · Intensive	Proche de l'examen, peu de temps	Maîtriser les points à fort coefficient en peu de temps	Calibration de l'examen ; n'étudier que le cœur et l'important ; utiliser directement les vrais sujets pour vérifier
Révision · Approfondie	Vise une note élevée, suffisamment de temps	Maîtrise réelle	Calibration de l'examen ; explication complète de tous les points de connaissance du périmètre ; d'abord faire des sujets simulés, garder les vrais sujets pour la fin

Informations à connaître (ne pas demander si elles peuvent être déduites des supports) :

Objectif d'apprentissage : comprendre, suivre le cours ou réviser
Supports disponibles
Niveau actuel
Date limite ou date d'examen
Temps d'étude quotidien possible
Format de l'examen : langue de réponse, possibilité de notes, restrictions de calculatrice

Un même cours peut d'abord être en "Suivi de cours", puis en "Révision" en fin de semestre. Dans ce cas, ne créez pas une nouvelle page, mais ouvrez la section de révision dans la page existante (voir section III).

II. Fichier de données du cours

Chaque cours maintient un course.json, à partir duquel la page est générée. Pour les mises à jour, modifiez ce fichier, puis régénérez la page.

Conservez-le à deux endroits pour pouvoir continuer lors de la prochaine conversation :

data/course.json dans le dossier de la page web
_page_apprentissage/course.json dans le dossier du cours de l'utilisateur (si l'écriture est possible)

Avant de mettre à jour, lisez ce fichier. Si introuvable aux deux endroits, restaurez-le à partir de la page publiée et informez l'utilisateur.

{
  "course": {"code":"…", "name":"…", "profile":"self|self-plan|course|exam-sprint|exam-deep",
             "exam": {"date":"…", "format":"…", "answer_lang":"en|fr", "allowed":"…"}},
  "sources": [{"id":"W03L1", "file":"…", "url":"…", "type":"lecture|transcript|textbook|tutorial|lab|assignment|sample_exam|past_exam|exam_info|web", "week":3, "added":"…"}],
  "modules": [{"id":"M-sql-basic", "name":"…", "order":5}],
  "points": [{
    "id":"sql-left-join",        // ID stable, ne jamais modifier après génération
    "no":57,                      // Numéro d'affichage, à réorganiser à chaque génération
    "title":"Résumé en une phrase",
    "module":"M-sql-basic",
    "week":5,
    "tier":3,                     // 3 cœur / 2 important / 1 secondaire / 0 non évalué (les auto-apprentissages peuvent ne pas être hiérarchisés)
    "depth":"apply",              // recall reconnaître / explain expliquer / apply utiliser / transfer transférer
    "pre":[{"id":"sql-inner-join","kind":"hard"}, {"id":"null","kind":"soft","why":"IS NULL"}],
    "src":[{"source":"W05L1","page":24}, {"source":"W05L1-transcript","time":"32:10"}],
    "exam_refs":["Échantillon 2 Q2A"],
    "mastery":"Quelle question résolue prouve la maîtrise (une phrase, doit être vérifiable par une question)",
    "status":"active|merged|deprecated",
    "changed":"Date : ce qui a changé",
    "note":"Non évalué / Complément / Le professeur a dit…"
  }],
  "storyline": [{"from":"M-tree", "to":"M-rf", "why":"Une phrase : quel problème le module précédent a laissé, comment le suivant le résout"}],
  "lessons": [{"id":"L-w05", "track":"learn|review", "title":"…", "points":[…], "steps":[…],
               "storyline":[{"role":"Problème|Idée|Méthode|Résultat|Nouveau problème", "text":"Une ou deux phrases", "formula":"Optionnel, forme la plus simple", "steps":[3,4]}]}],
  "questions": [ … voir section VIII … ],
  "changelog": [{"date":"…", "summary":"…", "added":[…], "changed":[…], "conflicts":[…]}],
  "course_notes": [{"date":"…", "note":"Préférences ou corrections spécifiques à ce cours (ex. notation, module à approfondir), à respecter lors des futures mises à jour"}]
}

Règles :

ID stable : la progression, les cases cochées, les erreurs sont stockées par ID, donc la progression de l'utilisateur n'est pas perdue après une mise à jour.
Ne supprimez pas les points de connaissance. Marquez deprecated ceux qui ne sont plus nécessaires ; marquez merged ceux qui sont fusionnés et pointez vers le nouvel ID.
pre n'écrit que les prérequis directs. hard signifie qu'ils doivent être appris en premier ; soft signifie qu'un seul concept est utilisé, et précisez lequel.

III. Structure de la page : une page par matière

La matière entière est une page (_page_apprentissage/index.html, voir "Zéro. Configuration de l'environnement"). Utilisez des onglets en haut pour basculer entre les sections, et des hashs d'URL pour le ciblage (par exemple #map, #lesson/L-w05/3, #q/q-id), facilitant les liens entre les sections.

Sections, et ce qu'elles affichent selon le type

| Section | Contenu | Auto-apprentissage (y compris planification de zéro) | Suivi de cours | Révision | |---|---|---|---| | Carte | Graphe topologique des modules, tous les points de connaissance (cases à cocher, prérequis, sources), progression, panneau "Mise à jour" | ✓ (pour la planification de zéro, c'est le parcours d'apprentissage, avec ressources recommandées) | ✓ | ✓, ajout d'une "Vue examen" | | Leçon | Explication pas à pas, avec auto-évaluation à chaque étape | ✓ (par chapitre ou phase) | ✓ (par semaine) | ✓, ajout d'une "Ligne de révision" | | Exercices | Questions auto-générées par point de connaissance (pour les révisions, les questions simulées sont également ici, avec un tag de filtre) ; le filtre "Non maîtrisé" sert de carnet d'erreurs | ✓ | ✓ | ✓ | | Analyse d'examen | Faits sur l'examen, priorités des supports, tableau question par question, poids des modules, liste des éléments non évalués, paroles du professeur | — | — | ✓ | | Questions simulées | Intégrées à la page d'exercices, avec le tag "Simulation", pas de section séparée | — | — | Version approfondie | | Sujets réels | Échantillons et sujets des années précédentes (manuel d'entraînement) | — | — | ✓ (version approfondie : d'abord gardés scellés) | | Aide-mémoire provisoire | Stockage temporaire de ce que vous ne voulez pas mémoriser pendant l'apprentissage, à organiser ultérieurement par l'IA, pour générer une fiche de notes (voir section VI, point 5) | — | — | ✓ (lorsque les notes sont autorisées à l'examen) |

Le graphe topologique doit être généré

Chaque page doit avoir un graphe topologique des points de connaissance dans la section Carte. Quelle que soit la spécification, le temps disponible ou si la confirmation a été sautée, il doit être généré. Les prérequis doivent également être inclus (par exemple, pour apprendre "Qu'est-ce qu'une API", incluez les prérequis comme le client, le serveur, la requête HTTP).
Il n'y a que deux cas où vous pouvez ne pas le tracer : le contenu à apprendre est très restreint (seulement 1 à 3 points de connaissance), ou il n'y a effectivement pas de relation d'ordre. Dans ce cas, écrivez une phrase dans la section Carte indiquant pourquoi il n'y a pas de graphe.
En cas de manque de temps, vous pouvez réduire le nombre d'étapes de la leçon et le nombre de questions, mais pas supprimer le graphe topologique.

Disposition de navigation (priorité à la leçon et aux exercices)

La leçon et les exercices sont les éléments principaux ; la carte, l'analyse d'examen et le parcours d'apprentissage ne sont que des vues d'ensemble, et ne doivent pas occuper la majeure partie de l'espace en haut.
En haut, une barre collante sur une seule ligne : code du cours + onglets des sections principales + compte à rebours / progression / terme / bouton de code de progression. Les sections principales sont uniquement : Leçon (ouverte par défaut), Exercices (sous-pages : Pratique, Sujets réels), Aperçu (sous-pages : Carte, Analyse d'examen, Parcours d'apprentissage), Aide-mémoire (lorsque la fonction de stockage provisoire est active).
La deuxième ligne contient les sous-onglets de la section principale en cours, ainsi qu'une ligne de saisie d'aide-mémoire (qui se développe lorsqu'elle est focalisée).
La section Analyse d'examen est conservée dans toutes les pages de révision ; une fois le contenu écrit, il ne change pas ; le parcours d'apprentissage évolue avec la progression, l'utilisateur peut ne pas s'y référer, il suffit de le placer dans l'Aperçu.

Faible coût d'entrée

La personne qui reçoit la page ne doit pas avoir besoin d'apprendre à l'utiliser.

La première fois que chaque section est ouverte, une brève explication de couleur claire en haut (pouvant être fermée) explique en une phrase comment utiliser cette page, par exemple "Ne cochez pas 'Maîtrisé' pour les questions dont vous n'êtes pas sûr ; filtrer 'Non maîtrisé' vous donne votre carnet d'erreurs".
Il n'y a qu'un seul type de carte de question sur tout le site : énoncé → options ou champ de saisie → indice / voir la réponse → case à cocher "Maîtrisé" en haut à droite. Les auto-évaluations de la leçon, les exercices et les sujets réels l'utilisent ; apprenez une fois, utilisez partout.
Les boutons sont écrits avec des verbes ("Voir la réponse", "Suivant"), pas de boutons avec seulement des icônes ; le nombre de filtres et d'interrupteurs par page est réduit ; les fonctions rarement utilisées ne sont pas implémentées.
Pour une même action, un seul point d'entrée et un seul état ; ne faites pas coexister des états aux significations similaires comme "Corrigé", "Annuler", "Maîtrisé".

Toutes les opérations de persistance doivent être annulables

Les personnes qui reçoivent une nouvelle page vont d'abord cliquer un peu partout. Par conséquent, toute opération qui sera sauvegardée doit pouvoir être annulée, sans laisser de trace après un essai.

Interrupteurs ("Maîtrisé", cocher un point de connaissance, étape "Terminée") : recliquer annule, ne faites pas en sorte qu'on ne puisse que cocher sans pouvoir décocher.
Enregistrements de réponses : chaque question a un bouton "Refaire", qui efface la réponse et le feedback pour cette question, la ramenant à l'état non commencé.
Les opérations qui peuvent faire perdre des données (effacement, suppression, importation) : après l'opération, une barre de notification apparaît en bas "Effacé · Annuler" ; cliquer sur "Annuler" dans les 8 secondes restaure complètement l'état. N'utilisez pas confirm() du navigateur.
- L'effacement du chronomètre, la suppression d'éléments de l'aide-mémoire, l'importation d'un code de progression utilisent cette barre
- La suppression de l'aide-mémoire utilise une suppression douce : déplacez l'élément dans la section "Récemment supprimé" en bas de la page ; il peut être restauré même après le délai de la barre
- Avant d'importer un code de progression, sauvegardez automatiquement la progression actuelle
Réinitialisation complète : dans la fenêtre du code de progression, placez "Effacer toutes mes données", pour permettre de recommencer après un essai. Avant cela, sauvegardez automatiquement ; après l'effacement, un bouton "Restaurer l'enregistrement précédent" reste dans la même fenêtre.
Implémentation : avant chaque écriture qui peut faire perdre des données, stockez un snapshot de la partie d'état concernée ; annuler signifie réécrire le snapshot. La sauvegarde de la réinitialisation complète est stockée dans une clé localStorage distincte, écrasée uniquement lors de la prochaine réinitialisation.

Comment gérer la coexistence des modes Apprentissage et Examen

Une seule carte, avec un commutateur "Vue apprentissage / Vue examen" :
- Vue apprentissage : organisée par semaine ou chapitre, affiche tous les points de connaissance
- Vue examen : organisée par poids à l'examen ; les points de connaissance en dehors du périmètre de l'examen sont grisés ; affiche les étiquettes de provenance des sujets et le chemin d'apprentissage
Les deux vues partagent le même ensemble de cases de progression.
Deux lignes de leçons :
- Ligne d'apprentissage : les leçons faites pendant le semestre par semaine, toujours conservées
- Ligne de révision : les leçons ajoutées pendant la révision, organisées selon le chemin d'apprentissage. La ligne de révision ne répète pas ce qui a déjà été appris : pour les points déjà appris, une seule carte de révision compressée, liée à l'explication originale de la ligne d'apprentissage, et ajoutant la perspective de l'examen (comment la question est posée, à quel niveau répondre, erreurs courantes). Seuls les points de connaissance nécessaires pour l'examen et non expliqués en détail dans la ligne d'apprentissage sont développés
Un seul ensemble de questions d'exercices : les questions d'auto-évaluation habituelles et les questions simulées de révision sont toutes dedans, filtrables par tag. Le carnet d'erreurs est partagé entre les deux modes
Les sections Analyse d'examen et Sujets réels n'apparaissent que pendant la révision. Le manuel de sujets réels appartient à la révision, et n'est pas inclus dans le mode Apprentissage

Fonctionnalités générales de la page

En haut : nom du cours, type, progression totale, et compte à rebours de l'examen (en révision)
Chronomètre : dans le coin supérieur droit de chaque carte d'étape (position visible, pas caché dans la barre latérale), affiche "Temps de cette étape mm:ss · Cumul du cours", se met à jour chaque seconde ; boutons "Pause/Continuer" et "Effacer" (efface uniquement l'étape en cours, une barre "Annuler" apparaît après) ; l'état de pause est maintenu entre les étapes ; se met en pause automatiquement lors du changement d'onglet ; le temps est enregistré pour l'étape ou la question en cours
Fenêtre contextuelle de la ligne directrice : ouvrable à tout moment pour voir la ligne directrice logique de la leçon en cours, avec mise en évidence de "Vous êtes ici" (voir section VII "Ligne directrice logique")
Fenêtre contextuelle du glossaire (bilingue, chaque terme avec une phrase d'explication) ; pour les cours de mathématiques et de statistiques, ajoutez un traducteur de symboles
Liens vers les diapositives : utilisez des chemins relatifs pointant vers le fichier PDF original dans le dossier du cours, avec #page=N (le lecteur PDF intégré au navigateur sautera à la page correspondante) ; les transcriptions marquent les points temporels ; les ressources en ligne donnent le lien original
Code de progression : exporte un texte à envoyer à l'IA, qui saura où sont les lacunes. L'importation n'ajoute que des coches, n'en supprime pas ; avant l'importation, sauvegarde automatique, annulable
Tous les états sont stockés dans localStorage avec la clé "code du cours + ID stable", la lecture et l'écriture sont toujours encapsulées dans try/catch
Une palette de couleurs unifiée, avec mode sombre, cohérente pour une même matière
Adaptation mobile : la barre latérale devient empilée en haut, les tableaux défilent horizontalement, et s'adaptent à la zone de sécurité
Formules avec sortie SVG de MathJax (tex-svg), règles de notation et de formatage dans la section VII "Formatage et notation"
Graphe topologique : lorsque le nombre de points de connaissance est élevé, utilisez Graphviz pour pré-calculer la disposition, dessinez un SVG cliquable et zoomable dans la page ; en cliquant sur un point, ses prérequis et successeurs s'affichent ; "Voir par question" permet d'afficher tous les points nécessaires pour une question. Les petits graphes au niveau des modules peuvent utiliser Mermaid
Captures d'écran des sources : exportez uniquement les pages de diapositives référencées par les points de connaissance (utilisez des outils en ligne de commande comme pdftoppm pour exporter directement en PNG à partir du PDF, sans parcourir page par page, consommant presque zéro token), placez-les dans img/ du dossier de la page ; cliquez sur la source pour voir l'image dans une fenêtre (car le navigateur ne peut pas ouvrir une page spécifique d'un fichier PPT)
Les données de la page sont directement intégrées dans index.html ; data/course.json est conservé séparément comme original

IV. Création (avec supports)

1. Lire les supports

Utilisez les outils de fichier à votre disposition pour lire le dossier ou les fichiers téléchargés par l'utilisateur. Lisez chaque fichier complètement : les pages scannées et manuscrites nécessitent une OCR, les images doivent être examinées une par une.
Les transcriptions de cours et les textes de cours en ligne sont tout aussi importants : les exemples donnés oralement, les points importants soulignés ("ça tombera à l'examen", "beaucoup de gens se trompent ici"), les explications non présentes sur les diapositives doivent être extraites, avec indication du point temporel.
Commencez par fournir à l'utilisateur une liste des fichiers, en indiquant ceux qui n'ont pas pu être lus.

2. Périmètre et exactitude

Suivi de cours et révision : le périmètre est celui des diapositives et du cours ; n'ajoutez pas de contenu extérieur. Les connaissances de base nécessaires doivent être marquées "Complément". La notation est cohérente avec les diapositives.
Auto-apprentissage compréhension : le périmètre est celui de l'objectif d'apprentissage de l'utilisateur ; les supports ne sont qu'un point de départ. Si les supports sont peu clairs ou contiennent des erreurs, vous pouvez ajouter des explications faisant autorité, mais en les signalant. Les transcriptions de cours en ligne contiennent souvent des erreurs de reconnaissance et des lapsus ; corrigez-les en contexte et vérifiez les faits et formules clés par rapport à des sources fiables. Les incertitudes doivent être indiquées.

3. Décomposer les points de connaissance

Granularité fine : chaque point ne traite que d'une seule chose (une définition, une propriété, une méthode, un type de question ou un piège). Si un point contient deux choses vérifiables séparément, continuez à décomposer.
Pour l'apprentissage, la profondeur suit d'abord ce que dit le support : si le support fait une démonstration, c'est explain ; s'il fait un exemple d'application, c'est apply. Pour l'auto-apprentissage, la profondeur est déterminée par l'objectif de l'utilisateur.

4. Construire la topologie

Formez un graphe orienté acyclique. Si une boucle apparaît, cela signifie que vous avez mal décomposé ; recommencez.
Pour le suivi de cours : organisez par semaine, et par dépendance au sein de chaque semaine. Pour l'auto-apprentissage : organisez entièrement par dépendance.
Le graphe des modules utilise Mermaid flowchart : les lignes pleines indiquent les prérequis obligatoires, les lignes pointillées indiquent qu'un seul concept est utilisé (précisez lequel) ; utilisez des couleurs pour distinguer l'importance ; écrivez les plages de numéros sur les nœuds. Sous le graphe, un paragraphe résume les grandes lignes de l'ensemble du graphe.

5. Confirmer d'abord le graphe topologique, puis générer

Ce que l'utilisateur doit confirmer est le graphe topologique des points de connaissance, pas le cheminement des modules. Procédez comme suit : décomposez d'abord tous les points de connaissance un par un, mélangez-les ; à partir des points nécessaires pour les questions d'examen (ou les objectifs d'apprentissage), trouvez leurs prérequis, les prérequis de ces prérequis, etc., pour former le graphe topologique. Les relations de prérequis doivent traverser les modules (par exemple, une question du module 8 utilise un outil du module 7, un concept d'un cours prérequis), afin que l'explication de la page soit plus fluide que celle des supports scolaires.
Numérotez les points de connaissance dans l'ordre des "prérequis immédiats" : chaque prérequis est placé juste avant sa première utilisation ; ne mettez pas tout le contenu prérequis en début de page.
Vous pouvez d'abord publier une première version de la page ne contenant que la carte, l'analyse d'examen et le parcours d'apprentissage, permettant à l'utilisateur de confirmer directement sur le graphe interactif ; après confirmation, générez les leçons et la base de questions par lots.
Les connaissances prérequises doivent également être organisées en cours séparés par source (par exemple "Matrices et rang (rapide prérequis)"), et la 0ème étape de chaque cours liste "Assurez-vous de maîtriser ceci (venant d'autres cours)" avec des liens.
Demandez à l'utilisateur de confirmer le graphe topologique uniquement s'il peut juger : lorsque l'utilisateur a des diapositives, un programme d'examen, ou déjà des bases pertinentes, envoyez-le lui pour confirmation. Lorsque l'utilisateur est débutant, ne lui demandez pas, car il ne peut pas juger de l'exactitude ; l'IA elle-même vérifie par rapport aux diapositives ou aux sources faisant autorité, puis intègre directement le graphe dans la page.
En cas de saut de confirmation (que ce soit parce que l'utilisateur est débutant ou par manque de temps), le graphe topologique est quand même généré et placé dans la section Carte.

IV-2. Sans supports : planifier d'abord le parcours

1. Clarifier l'objectif

Quel niveau atteindre, dans quel but (lire un article, faire un projet, un entretien, par intérêt)
Les bases pertinentes sont-elles acquises
Combien de temps par semaine

Ne demandez pas ce qui peut être déduit de la conversation.

2. Rechercher

Avec une recherche internet, trouvez les ressources reconnues dans ce domaine : cours en ligne universitaires (page d'accueil du cours, supports, vidéos), manuels classiques, documentation officielle, articles de synthèse. Privilégiez les sources originales et faisant autorité, notez les liens et les chapitres ou séances spécifiques.
Comparez 2 ou 3 plans de cours de sources faisant autorité, et résumez les principales parties du domaine, les bases, les éléments avancés, et leurs relations d'ordre.

3. Proposer un parcours d'apprentissage, d'abord à confirmer

Panorama du domaine : quelles sont les parties du domaine ; pour l'objectif de l'utilisateur, quelles parties sont obligatoires, lesquelles peuvent être ignorées pour l'instant.
Vérification des prérequis : de quelles bases a-t-on besoin. Si l'utilisateur n'est pas sûr de ses compétences, proposez 3 à 5 petites questions de diagnostic, et ajustez le point de départ en fonction des résultats.
Ressource principale : recommandez un cours ou un manuel comme fil conducteur, les autres en complément, avec justification (autorité, niveau de difficulté adapté, gratuité ou non).
Parcours par phases : chaque phase doit préciser :
- Objectif d'apprentissage (vérifiable)
- Concepts clés
- Ressources recommandées (spécifiques au chapitre ou à la séance, avec liens)
- Temps estimé
- Méthode de vérification de la phase
Expliquez entre les phases "ce que la phase précédente a résolu, et quel nouveau problème la phase suivante va résoudre".
Ce que l'utilisateur doit confirmer, ce sont l'objectif, le temps et la ressource principale. Le graphe topologique des points de connaissance n'a pas besoin d'être confirmé par l'utilisateur : l'IA le vérifie par rapport aux sources faisant autorité, puis l'intègre directement dans la page.

4. Après confirmation du parcours par l'utilisateur, créez la page

Le parcours d'apprentissage est la carte. Les données de recherche sont notées comme sources (type web ou textbook), et chaque point de connaissance est marqué avec sa source.
Les explications sont rédigées par l'IA à partir de ces sources ; les faits et formules clés doivent être vérifiés, avec des liens originaux pour permettre à l'utilisateur d'approfondir.
Lorsque l'utilisateur obtient par la suite des manuels, des transcriptions de cours ou des notes de cours, traitez-les comme de nouveaux supports dans une mise à jour incrémentielle (section V) : ajoutez des sources, ajoutez de la profondeur, ne repartez pas de zéro.

5. Méthode d'explication progressive

Chaque étape commence par une question, un phénomène ou un besoin. Laissez d'abord l'utilisateur réfléchir, peut-être choisir une supposition, puis révélez la réponse et la raison.
Une étape ne fait qu'un petit pas, utilisant ce qui a déjà été appris pour introduire du nouveau.
Pour les parties difficiles, commencez par le cas particulier le plus simple, puis généralisez.
À la fin de chaque phase, faites le point : maintenant, vous pouvez faire ceci, et il reste encore ces problèmes que les connaissances actuelles ne résolvent pas, et la phase suivante les résoudra.

IV-3. Initiation légère (durée totale inférieure à 3 heures)

1. Comment déterminer

Si les deux conditions suivantes sont remplies, traitez comme initiation légère :

L'utilisateur demande un concept ou un petit sujet, par exemple "Qu'est-ce que X", "Initiation à X", "Je voudrais comprendre X"
Le temps d'apprentissage total estimé est inférieur à 3 heures, environ pas plus de 15 points de connaissance, 1 à 3 leçons

Si le volume dépasse cela, passez au mode "Auto-apprentissage compréhension" ou "Planification de zéro".

2. Procédure

Ne posez pas de questions, sauf si le sujet lui-même n'est pas clair.
Ne proposez pas de parcours à confirmer : déterminez vous-même les points de connaissance et l'ordre, et générez directement la page.
Si vous ne connaissez pas le niveau de l'utilisateur, partez du principe qu'il est un "débutant intelligent". Les prérequis nécessaires ne nécessitent pas d'être appris séparément ; donnez plutôt un "aide-mémoire prérequis" à l'étape 0 : chaque prérequis expliqué en une phrase.
Si vous avez accès à Internet, utilisez la recherche pour vérifier les faits et formules clés, et donnez des liens dans les sources.

3. Page simplifiée

Ne conservez que trois sections :
- Leçon : 1 à 3 leçons, 5 à 10 étapes chacune
- Exercices : 1 à 2 questions par point de connaissance
- Carte simplifiée : petit graphe topologique des points de connaissance, incluant les prérequis (par exemple, pour apprendre une API, le client, le serveur, HTTP), plus une ligne directrice
Pas d'analyse d'examen, de questions simulées, de sujets réels, de chronomètre, de file d'attente de révision ou de code de progression.
Conservez toujours :
- D'abord l'intuition, puis la définition, un exemple tout au long
- La boîte "En français" (pour les matières mathématiques)
- La ligne directrice logique à la fin de chaque leçon
- Le critère de maîtrise et l'auto-évaluation pour chaque point de connaissance, avec une explication ciblée en cas d'erreur
La dernière page indique "Ce que vous pouvez apprendre ensuite". Si l'utilisateur souhaite approfondir, la compétence peut être mise à niveau vers "Auto-apprentissage" ou "Planification de zéro", en étendant la même page. Par conséquent, course.json doit également être sauvegardé normalement.

V. Mise à jour incrémentielle (chaque semaine ou toutes les deux semaines)

Lisez course.json et les nouveaux supports.
Extrayez les points de connaissance des nouveaux supports, comparez-les un par un avec les points existants, et classez-les dans l'un des cas suivants :

Cas	Traitement
Nouveau contenu, tous les prérequis existent déjà	Ajouter
Extension ou approfondissement d'un point existant	Créer un nouveau point de connaissance, avec l'ancien comme prérequis hard ; ne pas intégrer dans l'ancien point
Même chose qu'un point existant	Ne pas créer de nouveau. Ajouter des sources à l'ancien point ; si la profondeur a augmenté, mettre à jour `depth`
Le professeur a corrigé un contenu précédent	Modifier l'ancien point, écrire dans `changed`, ajouter une marque "Corrigé" dans la page
Prérequis ajouté après coup (le nouveau contenu était en fait la base d'un ancien point)	Ajouter ce prérequis, ajouter l'arête de prérequis à l'ancien point. La leçon déjà publiée n'est pas réorganisée ; ajoutez une carte "Revoir" dans la nouvelle leçon, liée à l'ancien point, expliquant comment le comprendre maintenant
Contradiction entre anciens et nouveaux supports (notation ou formulation différente)	Noter les deux formulations, marquer "À confirmer", demander à l'utilisateur laquelle privilégier lors de la livraison
Ajout d'une arête créant une boucle	Décomposer le point de connaissance trop grossier, marquer l'ancien ID comme `merged`, pointer vers les nouveaux points
Nouveau thème	Créer un nouveau module. Si le nouveau contenu peut être intégré dans un module existant, étendez-le ; ne modifiez pas les noms de modules à la légère

Validation : tous les ID pointés par pre existent et sont active ; pas de boucle dans le graphe ; aucun point de connaissance n'est avant son prérequis hard (sauf pour les prérequis ajoutés après coup, mais avec une carte "Revoir").
Les anciens points de connaissance dont le contenu a changé sont marqués "Mis à jour, révisez si possible", mais la case cochée de l'utilisateur est conservée.
Écrivez dans le changelog et affichez dans le panneau "Mise à jour" de la carte : nombre d'ajouts, de corrections, de prérequis ajoutés après coup, d'éléments à confirmer.
Régénérez la page, écrivez dans le même dossier de page (si la page hébergée existe, publiez à la même adresse), l'URL ou le lien de l'utilisateur reste inchangé.

VI. Révision

1. Prendre l'examen comme point d'ancrage, déduire les points de connaissance

Hiérarchisez les supports : cible = les sujets d'échantillon ou les sujets des années précédentes avec corrigé officiel, référence = les autres sujets des années précédentes et les devoirs, fil conducteur = toujours les diapositives, les tutoriels et les TP en complément.
Décomposer les questions : chaque question est décomposée en sous-questions, puis en compétences testées, en listant "les points de connaissance nécessaires pour répondre correctement à cette sous-question".
Déduire le périmètre d'examen : à partir de ces points de connaissance, en suivant les prérequis hard en arrière, trouvez tous les points de connaissance nécessaires à l'examen. Les points de connaissance en dehors de ce périmètre sont rétrogradés en secondaires ou non évalués.
Calibration de la profondeur : déterminez la profondeur en fonction de la formulation de la question. Lorsqu'un même point est testé par plusieurs questions, prenez le niveau le plus profond :
- Jugement, choix → recall
- Explication, comparaison, pourquoi → explain
- Calcul, écriture de code, dessin, exécution d'étapes → apply
- Nouveau scénario, synthèse, conception → transfer
Vérification des lacunes :
- Contenu nécessaire à l'examen mais non traité dans les diapositives → écrivez une explication de bon sens, marquez "Non traité dans les diapositives"
- Contenu traité dans les diapositives mais explicitement exclu par les consignes d'examen → marquez "Non évalué"
- Contenu des années précédentes mais non traité dans les diapositives de cette année → listez séparément
Écrivez les résultats dans la section Analyse d'examen : tableau question par question (question → points de connaissance → points), tableau des poids des modules, liste des éléments non évalués, paroles du professeur (avec date), tendances des années précédentes, modèle de réponse général.
Chemin d'apprentissage : divisez en segments en fonction du temps disponible de l'utilisateur. La leçon est toujours organisée par module (un module = une leçon, les prérequis sont également organisés par source pour pouvoir être réutilisés) ; le chemin d'apprentissage ne fait que référencer les étapes de la leçon ("quelles étapes de quelles leçons apprendre aujourd'hui"), ne découpe pas la leçon par jour. Chaque segment liste les numéros à apprendre, explique pourquoi ils sont placés ici, et quelles questions utiliser pour vérifier l'apprentissage. La version intensive fournit en supplément une version minimale, avec la liste des numéros "à sacrifier en premier" ; la version approfondie planifie par jour, chaque jour incluant du nouveau contenu et des révisions à échéance.

2. Version intensive et version approfondie

	Version intensive	Version approfondie
Périmètre	Cœur et important	Tous les points de connaissance du périmètre
Explication	Jusqu'à suffire pour répondre aux questions	Expliquer complètement à la profondeur calibrée ; pour le niveau transfer, présenter des variations
Exercices	Test direct avec les sujets réels	D'abord faire des questions simulées, puis, une fois à l'aise, faire les sujets réels
Sujets réels	Apprendre en utilisant	Scellés : ne déverrouiller le sujet réel correspondant que lorsque toutes les questions simulées d'un type sont réussies ; à la fin, simulation chronométrée d'un sujet complet

En cas de manque de temps, coupez dans cet ordre : d'abord la réduction de l'explication des points secondaires, puis le nombre de questions, et enfin la compression des étapes de la leçon. Le graphe topologique et l'analyse d'examen ne sont pas réduits.

3. Questions simulées (obligatoire pour la version approfondie)

Pour chaque type de question d'examen, écrivez 3 à 6 questions simulées : testant les mêmes compétences, mais avec des scénarios et des données différents, d'un niveau de difficulté au moins équivalent à celui des sujets réels. Chaque question est marquée avec le type de sujet réel correspondant (par exemple "Type de l'échantillon 2 Q2D") et les compétences testées.
Ordre de création : d'abord des questions sur une seule compétence, puis des questions combinant plusieurs compétences, et enfin des questions d'un niveau de complexité équivalent à celui des sujets réels.
Après chaque module, les questions simulées de ce module sont placées immédiatement après.
Les questions simulées sont placées dans la page d'exercices, avec le tag "Simulation", pas de section séparée.

4. Manuel des sujets réels

Les modules sont triés par poids à l'examen ; le module 0 contient les informations sur l'examen et les stratégies de réponse ; chaque module commence par un encadré "À mémoriser".
Chaque question contient : étiquette de niveau (corrigé officiel / corrigé dérivé, ce dernier précisant qu'il n'est pas officiel), provenance et points, énoncé original, traduction en français (si l'examen est en anglais), une piste, la réponse par défaut pliée, case à cocher "Maîtrisé". Chaque sous-question utilise la carte de question standard du site.
Si l'examen est en anglais, la réponse commence par un segment prêt à être recopié en anglais, puis une explication en français du pourquoi.
Un chronomètre de sujet complet (durée préréglée de l'examen, pause, effacement possible) et un interrupteur "Déplier / Replier toutes les réponses". Pas de fonctions rarement utilisées comme le chronométrage par question, le surlignage de texte, la catégorisation des raisons de perte de points.

5. Aide-mémoire provisoire (ajoutez-le lorsque les notes sont autorisées à l'examen)

Une ligne de saisie en haut de la page : coller du texte et appuyer sur Entrée le sauvegarde ; le LaTeX est automatiquement rendu ; on peut coller directement des images (stockées en data URL). Coller n'importe où sur la page d'aide-mémoire le sauvegarde aussi.
Chaque entrée note le contexte de collage (quelle leçon, quelle étape, quel point de connaissance). Les entrées sont stockées dans localStorage.
Bouton "Tout copier (pour l'IA)" : l'utilisateur envoie le contenu avec le contexte à l'IA, qui organise les fragments en entrées lisibles (titre + texte, explication en français, conservation des termes anglais, formules en LaTeX), puis les réécrit dans les données de la page ; l'original est conservé, commutable.
Clic sur une carte pour la sélectionner (sélection multiple possible), menu contextuel "Supprimer la sélection", confirmation via une boîte de dialogue dans la page (pas confirm()) ; sur mobile, utilisez un bouton de barre d'outils. La suppression est douce : annulable via une barre de notification ou en restaurant depuis la section "Récemment supprimé".
Utilisation : pour créer une fiche de notes, le contenu de la page provisoire est intégré comme la partie "la moins solide" dans un petit bloc de l'aide-mémoire, le reste étant généré automatiquement par l'IA à partir du cours.

VII. Rédaction des explications

Commun à tous les types

Chaque leçon commence par l'étape 0 : quel problème cette leçon résout ; à la fin, vous devriez pouvoir... (liste numérotée vérifiable).
D'abord l'intuition, puis la définition, puis un exemple. Un exemple traverse toute la leçon, les étapes suivantes l'utilisent à nouveau.
Phrases courtes, en langage simple, pas de formules vides. Explication en français, conservez les termes anglais originaux ; si l'examen est en anglais, chaque étape marque les mots-clés en anglais.
La leçon n'affiche qu'une seule étape à la fois ; en bas, "Étape précédente" / "Étape suivante". En haut de la carte : N° de l'étape · Minutes estimées · ID du point de connaissance · Terme anglais.
La barre latérale gauche a trois niveaux, clairement distincts et non encombrés :
- Unité (Prérequis, Module X...) : barre de titre pliable, avec couleur et progression ; seule l'unité courante est dépliée par défaut ; n'enregistrez que les dépliages/replis effectués par l'utilisateur (ne considérez pas le déclenchement d'initialisation de <details> comme une action de l'utilisateur)
- Leçon : une ligne par leçon, avec un point de couleur du module à gauche et un petit indicateur de progression à droite ; la leçon en cours est encadrée et mise en évidence ; les leçons non générées sont grisées
- Étapes : dépliées uniquement sous la leçon en cours, reliées par une ligne temporelle verticale, chaque étape précédée d'un petit cercle numéroté (✓ si terminée), police plus petite, temps passé à droite ; le bouton "Ligne directrice de cette leçon" est placé au-dessus de la liste des étapes
Dans la carte, utilisez ces blocs de contenu selon le besoin :
- Encadré de formule ou de définition clé
- Encadré "En français"
- Encadré d'exemple
- Encadré "Point d'examen" : marque la provenance, se déplie ligne par ligne avec "Suivant"
- Encadré "Piège courant"
- Encadré "Méthode de réponse"
- "À savoir" (petite police)
- Carte "Revoir" (lors des mises à jour incrémentielles)
- Auto-évaluation
La révision doit aussi faire comprendre la discipline : les échantillons ne représentent que les types de questions et les questions typiques, pas que les éléments hors périmètre ne tomberont pas. L'objectif est d'apprendre, l'examen n'est qu'une vérification.
- Le "Pourquoi apprendre cela maintenant" à chaque étape écrit la motivation disciplinaire (quel problème l'étape précédente a laissé, comment celle-ci le résout), pas "parce que ça tombe à l'examen" ; les sources des questions sont listées séparément à la fin de chaque étape
- Les points de connaissance hors périmètre sont quand même inclus dans la leçon et expliqués clairement, simplement marqués comme secondaires

Structure fixe d'une étape d'explication

Chaque étape suit l'ordre ci-dessous. Si un élément n'est pas présent, sautez-le, mais ne changez pas l'ordre :

Pourquoi maintenant : une phrase, écrit la motivation disciplinaire (quel problème l'étape précédente a laissé, comment celle-ci le résout)
Intuition : 1 à 3 phrases, ou utilisez des chiffres concrets de l'exemple fil rouge pour poser le problème
Définition / Encadré de formule clé : la formule sur une ligne séparée, centrée
En français : juste en dessous de la formule, expliquez d'abord chaque symbole un par un (ce que c'est, la forme : nombre / vecteur / matrice, aléatoire ou fixe), puis une phrase sur "quand une variable augmente, comment le résultat change"
Encadré d'exemple : refaire le calcul avec les chiffres de l'exemple fil rouge, une ligne par étape
Encadré "Piège courant" (s'il y en a)
Auto-évaluation : 1 à 2 questions, vérifiant exactement le critère de maîtrise de cette étape
Source de la question : dernière ligne en petits caractères, listant les sous-questions de sujets réels qui testent cette étape

Règles fixes pour les formules et le formatage (se référer à la leçon de révision de MAST90138)

En ligne ou en ligne séparée : les petits symboles s'écrivent en ligne ( $\hat\beta_1$ ) ; les définitions, formules clés, conclusions à mémoriser sont sur une ligne séparée, centrées.
Chaîne de déduction : utilisez aligned, alignement sur le signe égal, chaque ligne avec \quad\text{(justification)} à droite ; les inégalités ou formules très longues utilisent aussi aligned, sans casser la carte.
Calcul numérique en trois étapes fixes : d'abord la formule → puis la substitution numérique → puis le résultat, conservant 3 à 4 chiffres significatifs ; tous les nombres sont vérifiés par code.
Dans les formules, utilisez \text{} uniquement pour de courts mots, pas de longues phrases en français.
Utilisez le vrai LaTeX, cohérent avec les diapositives : vecteurs et matrices en gras (\mathbf{X}, \boldsymbol\beta) ; les caractères de fantaisie lorsque nécessaire (information de Fisher \mathcal I, modèle \mathcal M, normale \mathcal N) ; les opérateurs et noms de distributions en romain (\operatorname{Var}, \mathrm{SS}_{\text{res}}, \mathrm{Bin}). N'utilisez pas d'Unicode pour bricoler les formules (XᵀX, β̂, F(2,4) ce genre) ; cela vaut aussi pour les titres de points de connaissance, les critères de maîtrise, les options, les indices, les traductions de sujets réels. Seules les étiquettes des nœuds du graphe topologique SVG utilisent du texte brut.
Dans la configuration de MathJax, définissez un ensemble de macros (par exemple \X, \bb, \SSres, \FI), partagées par tout le site, garantissant la cohérence de la notation ; lorsque vous utilisez \boldsymbol, chargez le paquet boldsymbol. Dans Python, utilisez toujours r"…" pour les chaînes contenant du LaTeX.
Les formules ne doivent pas contenir directement < ou > : lorsque les données sont insérées dans la page via innerHTML, <p dans $\rk(\X)<p$ serait interprété par le navigateur comme le début d'une balise HTML, avalant tout le reste, affichant un code tronqué comme $\rk(\X). Lors de la génération de la page, traitez uniformément : parcourez toutes les chaînes de données

... [tronqué pour la traduction]

Demander à votre IA préférée

Documentation