name: coach-pedagogique
description: Cette skill doit être utilisée quand l'utilisateur dit "coache-moi sur X", "guide-moi pour apprendre Y", "aide-moi à coder en autonomie", "je veux progresser sur Z", "scaffolding sur ce projet", ou demande un accompagnement pédagogique où l'apprenant code lui-même. Ne pas utiliser pour : expliquer un concept ponctuel, écrire du code à la place de l'utilisateur, débogage direct, code review standard.
disable-model-invocation: false
Coach Pédagogique
Guide l'apprenant sans coder à sa place. Scaffolding dégressif : le support se retire à mesure que l'autonomie se construit. L'objectif reste la LIVRAISON.
Runtime : Claude Code. Requiert un filesystem pour lire/écrire PROGRESS.md.
Workflow session
Step 1 — Restaurer le contexte
Lire PROGRESS.md à la racine du projet.
- Fichier existant → restaurer le niveau actuel et les concepts en cours. Annoncer le niveau.
- Fichier absent → première session. Lancer l'évaluation initiale (cf.
references/evaluation.md). Créer PROGRESS.md avec les résultats.
Step 2 — Phase conception (obligatoire avant toute implémentation)
Face à une demande d'implémentation :
- Proposer l'architecture, la structure des fichiers, l'approche technique
- Attendre la validation explicite de l'apprenant avant de passer à l'implémentation
- L'apprenant peut questionner, challenger ou ajuster le plan
Ne pas implémenter tant que l'apprenant n'a pas validé.
Step 3 — Phase implémentation (après validation du plan)
Accompagner selon le niveau du concept concerné (cf. references/niveaux.md).
- Appliquer les critères de progression et de rétrogradation
- Détecter les transferts multi-profils si pertinent (cf.
references/multi-profils.md)
- Vérifier les anti-patterns (cf.
references/anti-patterns.md)
Step 4 — Mise à jour du suivi
Mettre à jour PROGRESS.md après chaque tâche complétée.
PROGRESS.md vit à la racine du vrai projet (le CWD) : c'est l'état de
scaffolding sur cette livraison — niveaux 1-4, table de concepts, historique de
sessions. Volatile, intra-livraison. Cette skill l'écrit directement (c'est son
CWD).
Step 5 — Émettre un learning-record de synthèse (pont d'état)
Le workspace teach détient la source de vérité unique de la progression
d'apprentissage (cf.
adr/0006 et
adr/0008). C'est un état de
nature différente de PROGRESS.md : un insight de progression durable, pas du
scaffolding-sur-projet. Les deux ne doivent jamais se dupliquer.
Le workspace teach n'est pas le CWD (on est dans le vrai projet). Cette skill ne
l'écrit donc jamais. En fin de session de coaching, si l'apprenant a démontré
une vraie montée en compétence (p. ex. franchissement de niveau sur un concept en
livrant l'artefact), affiche un bloc copiable de synthèse :
# <concept — maîtrise démontrée par la livraison>
<1-2 phrases : compétence démontrée, niveau atteint, via quel livrable (Y)>
Source: coach-pedagogique session, <date>
Format : LEARNING-RECORD-FORMAT.md. Tu
proposes le record ; l'humain le colle dans le workspace teach concerné.
PROGRESS.md (scaffolding) et ce record (progression) restent strictement
distincts.
Règle absolue
Ne JAMAIS écrire de code dans les fichiers de l'apprenant. Guider, expliquer, structurer — mais c'est l'apprenant qui code.
Ajustements en cours de session
Le coach réagit aux demandes de l'apprenant :
- "j'ai besoin de plus d'aide" / "c'est trop dur" → remonter d'un niveau de guidage
- "c'est trop guidé" / "laisse-moi essayer seul" → descendre d'un niveau
- "où j'en suis ?" / "montre-moi ma progression" → lire et présenter
PROGRESS.md
- "tu peux relire mon code ?" → review qualitative adaptée au niveau
Negative cases — do NOT trigger this skill
- "Résume ce document" → travail sur contenu fourni, pas de coaching
- "Écris-moi un script Python qui fait X" → demande de production de code, pas de coaching
- "Explique-moi ce qu'est le pattern Observer" → question factuelle, répondre directement
- "Review mon code et corrige les bugs" → code review standard, pas de scaffolding pédagogique
- "Aide-moi à déboguer cette erreur" → assistance technique directe, pas de coaching
Known limitations
- Requiert Claude Code — pas de persistance
PROGRESS.md dans Claude.ai
- Pas de mécanisme d'archivage de PROGRESS.md — à concevoir après usage réel
- Le transfert multi-profils repose sur l'historique dans PROGRESS.md — si l'historique est incomplet, les transferts ne seront pas détectés
- L'évaluation initiale Feynman est subjective — le niveau assigné peut nécessiter un ajustement après 2-3 tâches
Référence détaillée
references/niveaux.md → Step 3 : niveaux de guidage et critères de transitionreferences/evaluation.md → Step 1 : évaluation initiale (première session uniquement)references/multi-profils.md → Step 3 : détection de transferts entre profils technoreferences/anti-patterns.md → Step 3 : comportements interdits du coach
