loselen/create-map

Que fait create-map ?

Construit le plus court chemin de nœuds enseignables depuis l'état actuel de l'apprenant jusqu'à l'objectif.

Basé sur : les hiérarchies d'apprentissage de Gagné (1968), l'analyse cognitive des tâches (Clark et al. 2008 ; Tofel-Grehl & Feldon 2013), le séquençage de tâches globales 4C/ID (van Merriënboer & Kirschner 2018), la taxonomie de Bloom révisée (Anderson & Krathwohl 2001), la frange externe de la théorie des espaces de connaissances, les composantes de connaissance (Koedinger et al. 2012).

Base de données : exécutez le script fourni depuis la racine du projet de l'apprenant (le dossier dans lequel la discussion a commencé) ; il conserve les données dans ./.learn/learn.db. ${CLAUDE_SKILL_DIR} est le dossier de cette compétence ; Claude Code le remplit automatiquement, et les autres agents doivent utiliser le chemin du dossier contenant ce SKILL.md.

Entrées

• L'objectif confirmé issu de clarify-me
• Le résumé de référence issu de check-me (solide / fragile / pas encore / idée fausse)

Procédure

1. Racine. Placez l'objectif en haut comme tâche globale.

2. Décomposer en arrière. Pour l'objectif, puis pour chaque nouveau nœud, demandez : « Que doit déjà être capable de faire l'apprenant pour réaliser cela ? » Posez aussi les questions d'expert que les gens oublient :

   • « Quelles décisions, indices et vérifications un expert utilise-t-il ici ? »
   • « Quelles erreurs les débutants commettent-ils couramment ici ? »

   Transformez les décisions cachées en nœuds ou conservez-les dans le titre d'un nœud.

3. Arrêter de décomposer une branche lorsqu'elle atteint un élément que check-me a marqué solide. Ne placez pas d'éléments solides sur la carte.

4. Taille adaptée pour chaque nœud. Un nœud :

   • a une capacité claire, formulée comme « peut [verbe] ... »
   • peut être enseigné en une courte leçon (environ 5 à 20 minutes de dialogue)
   • nécessite au maximum 3 résultats ; si plus, scindez-le ; s'il ne peut pas être vérifié seul, fusionnez-le

5. Inclure les lacunes. Les éléments fragiles deviennent des nœuds courts. Les idées fausses obtiennent leur propre nœud ou sont nommées dans le titre du nœud qui les corrige.

6. Ordre. Triez de sorte que chaque nœud vienne après ses prérequis. Placez les nœuds « pourquoi ça marche » juste avant les procédures qui en dépendent. Tous les quelques nœuds, incluez un petit nœud de tâche globale qui combine les précédents, pour ne jamais aboutir à un amas de fragments. Le nœud final est l'objectif lui-même.

7. Garder petit : environ 5 à 15 nœuds. Si vous en avez besoin de plus, l'objectif est trop lointain. Revenez à clarify-me et réduisez-le.

8. Afficher la carte sous forme d'un court chemin numéroté, puis demandez : « Ce chemin vous semble-t-il correct, ou y a-t-il quelque chose que vous connaissez déjà ou souhaitez sauter ? » Ajustez une fois.

9. Sauvegarder après que l'apprenant a accepté :

   python3 "${CLAUDE_SKILL_DIR}/scripts/db.py" new-map '{"goal": "<énoncé de l'objectif>", "baseline": "<résumé de check-me>"}'
   

   Puis ajoutez tous les nœuds en un seul appel. key est une étiquette courte de votre choix ; requires liste les clés des nœuds prérequis dans ce même appel (ou les identifiants de nœuds existants) :

   python3 "${CLAUDE_SKILL_DIR}/scripts/db.py" add-nodes '{"map_id": 1, "nodes": [
     {"key": "a", "title": "Peut ...", "requires": []},
     {"key": "b", "title": "Peut ...", "requires": ["a"]}
   ]}'
   

   Chaque nœud reçoit automatiquement sa date de création. Passez le JSON sur l'entrée standard avec un heredoc s'il contient des guillemets difficiles à échapper.

Modifier la carte plus tard

Si l'enseignement révèle un prérequis manquant, ajoutez-le avec add-nodes (utilisez l'identifiant du nœud existant dans requires lorsque cela s'applique) et expliquez brièvement à l'apprenant pourquoi.

Pièges

• Suivre l'ordre d'un manuel scolaire au lieu de ce dont l'objectif a besoin.
• Des nœuds trop gros (« apprendre le calcul ») ou trop petits (une seule définition).
• Réenseigner ce que l'apprenant a déjà montré comme solide.
• Une carte immense qui submerge l'apprenant.