Livre dont vous êtes le héros — Philo Bac

Démo pédagogique d'un dispositif d'apprentissage de la dissertation de philosophie de terminale, sous forme de fiction interactive jouée avec un narrateur LLM local et un corpus de citations vérifiées.

Lis le WARNING.md avant d'utiliser ce dispositif en contexte scolaire ou avec des élèves. Cette démo a des limites connues que tu dois comprendre pour l'utiliser sainement.

Pourquoi ce dispositif existe

Les outils d'IA générative sont déjà dans la vie des lycéens. Beaucoup les utilisent pour leurs devoirs, le plus souvent sans cadrage : ils interrogent un chatbot grand public, ils reçoivent une réponse plausible, ils copient. Le risque est double — ils apprennent à faire confiance à un outil qui peut leur inventer des citations fausses, et ils contournent le travail intellectuel que la dissertation est censée muscler.

Ce dispositif propose une alternative cadrée à cet usage par défaut, fondée sur quatre principes :

1. Corpus fermé et vérifié

Le narrateur n'a le droit de citer entre guillemets que des textes qui figurent dans un corpus de citations attestées par au moins deux sources web indépendantes (hostnames distincts). Pour chaque citation on conserve : le texte français de référence, le texte dans la langue originale quand applicable, le traducteur canonique, les variantes connues, et les URLs des sources.

Pas d'invention. Pas de plausibilité statistique. Si une citation n'est pas dans le corpus, le narrateur la paraphrase ou la refuse.

2. Vérification automatique en temps réel

Chaque réponse du narrateur est passée au crible d'un vérificateur qui extrait toutes les phrases entre guillemets, les compare au corpus (avec tolérance pour les variantes typographiques et accents) et vérifie l'attribution. Si une citation hallucinée ou mal attribuée est détectée, le système rejette la réponse et redemande au narrateur de la réécrire — sans que l'élève voie jamais la version fautive.

Au moment d'écrire ces lignes, quatre niveaux de garde-fous sont en place :

Injection d'un état explicite dans chaque tour (carte à jouer imposée par le serveur).
Validation post-génération (citation, état, alignement pédagogique du squelette).
Boucle de retry avec prompt correctif combiné.
Patch serveur défensif si le modèle reste têtu.

3. Mécanique pédagogique explicite

La dissertation se décompose en cinq opérations intellectuelles — problématiser, conceptualiser, illustrer, objecter, synthétiser. Dans ce dispositif, chaque tour de la fiction est exactement une de ces opérations. L'élève qui joue ne le sait pas pendant qu'il joue. À la fin de la session (au 5ᵉ tour), il peut demander à voir le squelette de dissertation qu'il vient d'écrire sans le savoir — révélant que ses choix narratifs successifs formaient en fait un plan dialectique argumenté.

C'est ce qu'on appelle en sciences de l'éducation un échafaudage (scaffolding) : porter temporairement l'élève au-dessus de ses moyens, pour qu'il ressente ce qu'on lui demandera bientôt de produire seul.

4. Traçabilité totale

Tout est auditable :

Le corpus complet est un fichier texte lisible avec les URLs sources de chaque citation.
Chaque session est persistée en clair (~/.livre-heros-bac/sessions/, format JSONL append-only).
Une vue admin (/admin) liste les sessions des 7 derniers jours et permet de lire le transcript détaillé avec, tour par tour, les diagnostics du vérificateur (citation validée / hors corpus, retries, patches serveur, violations détectées).

Aucune télémétrie, aucun envoi de données vers un service tiers. Le narrateur tourne en local sur ton poste (via LM Studio) ou sur une machine de ton réseau.

Comment ça marche, techniquement

Les pièces principales :

src/data/system-prompt.md — règles du narrateur (compteur, continuité narrative, cadres dramaturgiques, guide d'usage des citations).

Installation et utilisation

Prérequis

macOS / Linux / Windows
LM Studio ≥ 0.3 avec son CLI lms
Un modèle LLM chargé, idéalement Qwen3-30B ou plus (Qwen3-14B fonctionne mais avec qualité dégradée — voir WARNING.md section « Variabilité du modèle »)
Context length du modèle ≥ 16 K tokens

Installation

Lancement

Dans le chat LM Studio, invoque le tool exposé par le plugin :

Le navigateur s'ouvre sur le catalogue de sujets. Choisis-en un ou ajoute le tien, et lance une session.

Configuration

Tout est dans le panneau de config du plugin LM Studio (clic sur le plugin dans la liste) :

Où tourne le narrateur : local (ce poste) ou remote (autre machine LM Studio du LAN).
Modèle local : sélectionne dans la liste des modèles téléchargés (auto-détectés au démarrage du plugin).
Température, retries, etc.

État du projet : démo, pas produit

Soyons clairs : ce dépôt est une démonstration.

Pas de support utilisateur.
Pas d'engagement de disponibilité ou de roadmap.
Pas de garantie pédagogique (le dispositif peut produire des erreurs philosophiques que ses garde-fous ne détectent pas — voir WARNING.md).
Corpus volontairement limité (au moment d'écrire, ~15 citations sur la notion « liberté » uniquement vraiment couverte ; autres notions plus minces).

L'objectif initial n'est pas de servir directement des élèves à grande échelle, mais de montrer concrètement qu'on peut bâtir un dispositif d'IA pédagogique :

sans inventer de citations,
avec une mécanique pédagogique structurée et auditable,
en local, sans télémétrie, sans monétisation des données,
avec un coût d'infrastructure nul (utilise le LM Studio que l'utilisateur a déjà).

Vision communautaire — ce que ça pourrait devenir

Cette démo a la forme d'un seed. Si une communauté d'enseignant·e·s, de parents, de chercheur·e·s en sciences de l'éducation, et de développeur·euse·s s'agrège autour, elle peut devenir un outil pédagogique communautaire mature avec :

Côté corpus

Élargissement aux 17 notions du programme bac (corpus actuel concentré sur la liberté).
Auteurs au programme effectivement couverts (le BO 2019 liste ~80 auteurs canoniques ; on en couvre une douzaine).
Validation philologique par des enseignant·e·s de philosophie (vérification des traductions canoniques, ajout de variantes, contextualisation des citations).
Édition collaborative via le mécanisme déjà en place : chaque citation requiert au moins deux sources web distinctes pour entrer dans le corpus actif.

Côté pédagogie

Extension à d'autres disciplines à dissertation (histoire, français, SES).
Variantes du dispositif pour des niveaux différents (1ère, prépa).
Critique pédagogique du dispositif lui-même par des praticien·ne·s (qu'est-ce qui marche en classe ? qu'est-ce qui produit du faux sentiment de maîtrise ?).
Documentation des modes de défaillance observés (la liste des « misuses » connus dans src/skeleton-validator.ts est conçue pour grandir avec les sessions analysées).

Côté technique

Validation pédagogique fine via un second pass LLM critique (détecter les contresens d'interprétation que les règles déterministes ne voient pas).
Multi-modèles : permettre de comparer la qualité d'un même dispositif joué avec différents LLM.
Export du squelette en formats utilisables en classe (PDF, fiche de révision, slides).

Côté gouvernance

Décision de ce qui rentre dans le corpus canonique : un comité éditorial restreint, ou un mécanisme de vote, ou les deux ?
Code de conduite et processus de contribution clair.
Modèle économique soutenable sans monétiser les données d'élèves : sponsoring institutionnel ? Don ? Service de support optionnel pour les établissements ?

Rien de tout cela n'est en place. La démo existe pour rendre la conversation possible.

Contribuer

Si tu es :

Issues et PR sur le dépôt. Pas de hiérarchie de contributions préétablie ; on construit le processus à mesure que la communauté se forme.

Licence

MIT (voir package.json).

Le corpus (src/data/verified.jsonl) inclut des citations philosophiques toutes du domaine public, sourcées depuis Wikisource et des éditions universitaires en ligne. Les URLs des sources sont conservées avec chaque citation pour traçabilité.

Crédits

Architecture, code, prompts pédagogiques : Scanderia.
Construit comme démo à partir de LM Studio Plugin SDK.
Corpus initial basé sur Wikisource, palimpsestes.fr, philolog.fr, hyperspinoza.caute.lautre.net, et autres sources académiques en accès libre (URLs préservées dans le corpus).

Avant de jouer : WARNING.md. Avant de contribuer : essaie d'abord 3 sessions complètes pour comprendre les forces et faiblesses du dispositif en pratique.

livre-heros-bac