Créer des explications adaptées

Adapter une explication ne signifie pas uniquement la raccourcir ou remplacer des mots complexes.

Une explication adaptée doit tenir compte :

• des connaissances préalables ;
• de l'objectif ;
• du niveau d'abstraction ;
• des exemples disponibles ;
• des confusions probables ;
• du contexte d'utilisation.

Contrat d'entrée

CONCEPT :
{CONCEPT}

SOURCE :
{SOURCE}

PUBLIC :
{PUBLIC}

PREREQUIS :
{PREREQUIS}

OBJECTIF :
{OBJECTIF}

ERREURS PROBABLES :
{ERREURS}

FORMAT :
{FORMAT}

LONGUEUR :
{LONGUEUR}

Les couches d'une explication

1. Réponse directe

Une phrase qui répond à la question.

2. Définition

Les caractéristiques indispensables.

3. Mécanisme

Comment et pourquoi.

4. Exemple

Un cas représentatif.

5. Contre-exemple

Ce qui ressemble au concept sans en être un.

6. Limite

Quand la notion ne suffit pas.

7. Application

Comment l'utiliser.

8. Vérification

Question ou exercice.

Prompt maître

Explique le concept suivant au public indiqué.

CONCEPT :
{CONCEPT}

PUBLIC :
{PUBLIC}

PREREQUIS :
{PREREQUIS}

OBJECTIF :
{OBJECTIF}

SOURCE DE REFERENCE :
{SOURCE}

Structure :
1. réponse directe ;
2. définition précise ;
3. mécanisme ;
4. exemple adapté au public ;
5. contre-exemple ;
6. distinction avec les concepts proches ;
7. limite ;
8. application ;
9. question d'auto-explication ;
10. question de vérification.

Règles :
- n'utilise pas de terme non expliqué ;
- ne simplifie pas au point de supprimer les conditions ;
- distingue la source des analogies ajoutées ;
- signale toute incertitude ;
- conserve les nuances importantes.

Adapter à trois niveaux

Débutant

• peu de concepts simultanés ;
• vocabulaire défini ;
• exemple concret ;
• guidage ;
• comparaison simple.

Intermédiaire

• relations ;
• plusieurs exemples ;
• distinctions ;
• application ;
• limites.

Avancé

• hypothèses ;
• exceptions ;
• controverses ;
• modèles concurrents ;
• transfert complexe.

Prompt :

Produis trois versions de la même explication :
- débutant ;
- intermédiaire ;
- avancé.

Conserve la même idée centrale.
Indique ce qui est ajouté à chaque niveau.

Utiliser des analogies

Une analogie doit préciser :

• correspondance ;
• utilité ;
• limite.

Crée une analogie pour expliquer {CONCEPT}.

Présente :
1. la situation analogique ;
2. la correspondance terme à terme ;
3. ce que l'analogie aide à comprendre ;
4. ce qu'elle ne représente pas ;
5. une question permettant de revenir au concept réel.

Une analogie sans limite peut créer une mauvaise représentation.

Détecter les termes présupposés

Analyse cette explication.

Liste les termes qui supposent une connaissance préalable.
Pour chacun :
- définition nécessaire ;
- niveau estimé ;
- décision : expliquer, remplacer ou placer en prérequis.

Produire plusieurs exemples

Les exemples doivent varier sans changer la structure.

Crée :
- un exemple quotidien ;
- un exemple professionnel ;
- un exemple abstrait ;
- un contre-exemple ;
- un cas limite.

Explique le critère commun.

Cette variation prépare le transfert.

Explication socratique

Transforme l'explication en dialogue guidé.

Règles :
- une question à la fois ;
- attendre la réponse ;
- diagnostiquer l'erreur ;
- donner un indice minimal ;
- demander une reformulation ;
- terminer par un cas nouveau.

Cette version convient à un assistant interactif.

Contrôle de précision

Évalue cette explication selon :
- exactitude ;
- fidélité ;
- clarté ;
- prérequis ;
- exemples ;
- contre-exemples ;
- limites ;
- application.

Pour chaque problème, cite le passage et propose une correction minimale.

Erreurs fréquentes

Remplacer précision par simplicité

Une explication courte peut devenir fausse.

Utiliser une analogie comme preuve

L'analogie illustre. Elle ne démontre pas.

Donner trop d'exemples avant la définition

Le concept devient difficile à abstraire.

Employer du jargon implicite

Le niveau déclaré ne correspond pas au texte.

Ne pas demander de production

L'apprenant reconnaît sans expliquer.

Format réutilisable

Question :
Réponse directe :
Définition :
Mécanisme :
Exemple :
Contre-exemple :
Distinction :
Limite :
Application :
Auto-explication :
Vérification :

Checklist

• La première phrase répond-elle à la question ?
• Les prérequis sont-ils respectés ?
• Les termes sont-ils définis ?
• Le mécanisme est-il présent ?
• L'exemple est-il représentatif ?
• Un contre-exemple existe-t-il ?
• Les limites sont-elles indiquées ?
• L'analogie est-elle contrôlée ?
• L'apprenant doit-il expliquer ?
• Une vérification existe-t-elle ?

Étape suivante

À partir de ces explications, créez des quiz, des flashcards et des exercices.