Compétence : Créer un cours à partir d'une vidéo
Guide flexible pour utilisateurs finaux
Version : 2.0.0 Dernière mise à jour : 2025-11-24 Public cible : Clients / Créateurs de contenu Approche : Diagnostic interactif + Structure adaptative
Sommaire
- Philosophie de la compétence
- Flux de diagnostic
- Types d'entrée pris en charge
- Processus interactif
- Étapes d'exécution
- Modèles de transformation
- Exemples par scénario
- Résolution de problèmes
- Références
Philosophie de la compétence
Principes fondamentaux
┌─────────────────────────────────────────────────────────────────────┐
│ STRUCTURE = f(CONTENU) │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ ❌ FAUX : "Tout cours a 4 sections et 16 modules" │
│ │
│ ✅ CORRECT : "La structure émerge du diagnostic du contenu" │
│ │
│ • Vidéo de 30min → Peut être 1 module unique │
│ • Playlist de 50 vidéos → Peut être 5 sections de 10 modules chacune│
│ • Cours de 100h → Peut nécessiter une hiérarchie supplémentaire │
│ │
└─────────────────────────────────────────────────────────────────────┘
Ce qui n'est PAS fixe :
4 sections→ Nombre de sections défini par le contenu16 modules→ Nombre de modules défini par l'analyse32 heures→ Durée réelle du contenuFlashcards obligatoires→ Optionnels selon le besoin
Ce qui EST cohérent :
- Processus de diagnostic interactif
- Modèles de code React/Tailwind
- Nomenclature UX (Section, Leçon, Cours)
- Intégration avec le système existant
Flux de diagnostic
Étape 0 : Collecte d'informations (OBLIGATOIRE)
Avant toute action, Claude doit collecter :
┌─────────────────────────────────────────────────────────────────────┐
│ DIAGNOSTIC INITIAL │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ 1. TYPE D'ENTRÉE │
│ □ Vidéo unique (URL) │
│ □ Playlist YouTube (URL) │
│ □ Plusieurs vidéos distinctes (liste d'URL) │
│ □ Série/cours existant (description) │
│ │
│ 2. CARACTÉRISTIQUES DU CONTENU │
│ • Durée totale estimée : ___ │
│ • Nombre de vidéos : ___ │
│ • Thème/sujet principal : ___ │
│ • Public cible : ___ │
│ • Langue : ___ │
│ │
│ 3. OBJECTIF DU COURS │
│ □ Introduction/aperçu rapide │
│ □ Cours complet structuré │
│ □ Matériel de référence/consultation │
│ □ Formation en entreprise │
│ │
│ 4. RESSOURCES SOUHAITÉES │
│ □ Navigation par sections │
│ □ Cases à cocher de progression │
│ □ Flashcards │
│ □ Exercices pratiques │
│ □ Carnet de notes │
│ │
└─────────────────────────────────────────────────────────────────────┘
Questions de diagnostic (Claude doit poser)
## Diagnostic : Création de cours
Avant de commencer, j'ai besoin de mieux comprendre votre contenu :
1. **Quelle est l'entrée ?**
- URL d'une vidéo unique ?
- URL d'une playlist ?
- Liste de vidéos séparées ?
2. **Quelle est la durée approximative du contenu total ?**
- Moins d'1 heure
- 1 à 5 heures
- 5 à 20 heures
- Plus de 20 heures
3. **Comment imaginez-vous la structure du cours ?**
- Un module unique (contenu court)
- Peu de modules (2 à 5)
- Structure complète avec sections
- Je ne sais pas encore, j'ai besoin d'une suggestion
4. **Quelles ressources sont importantes ?**
- Progression avec cases à cocher
- Flashcards pour révision
- Navigation simple uniquement
Types d'entrée pris en charge
Matrice des formats
| Type d'entrée | Durée typique | Structure suggérée | Complexité |
|---|---|---|---|
| Vidéo courte unique | < 1h | 1 module, sections optionnelles | Faible |
| Vidéo longue unique | 1-5h | 3-8 modules, 1-2 sections | Moyenne |
| Vidéo très longue | 5-20h | Multiples sections et modules | Élevée |
| Petite playlist | 5-10 vidéos | 1 section par thème | Moyenne |
| Grande playlist | 10-50 vidéos | Multiples sections regroupées | Élevée |
| Très grande playlist | 50+ vidéos | Hiérarchie multi-niveaux | Très élevée |
| Vidéos distinctes | Variable | Analyse au cas par cas | Variable |
| Webinaire/Live | 1-3h | 1 module avec horodatages | Faible |
Décisions automatiques vs. interactives
AUTOMATIQUE (Claude décide) :
├── Modèle de code (React/Tailwind)
├── Structure de fichiers
├── Nomenclature des composants
└── Intégration technique
INTERACTIF (Utilisateur valide) :
├── Nombre de sections
├── Regroupement des modules
├── Noms/titres
├── Ressources optionnelles (flashcards, etc.)
└── Niveau de détail
Processus interactif
Flux de communication
┌─────────────────────────────────────────────────────────────────────┐
│ CYCLE D'ALIGNEMENT │
├─────────────────────────────────────────────────────────────────────┤
│ │
│ UTILISATEUR CLAUDE │
│ │ │ │
│ │──── "Je veux créer un cours" ──▶│ │
│ │ │ │
│ │◀─── Questions de diagnostic ──│ │
│ │ │ │
│ │──── Réponses ─────────────────▶│ │
│ │ │ │
│ │◀─── Proposition de structure ─│ │
│ │ "Basé sur votre entrée, │ │
│ │ je suggère X sections │ │
│ │ avec Y modules. D'accord ?" │ │
│ │ │ │
│ │──── Ajustements/Approbation ──▶│ │
│ │ │ │
│ │◀─── Exécution ────────────────│ │
│ │ │ │
└─────────────────────────────────────────────────────────────────────┘
Modèle de proposition de structure
## Proposition de structure
Basé sur l'analyse de votre contenu, je suggère :
### Aperçu général
- **Durée totale :** [X heures]
- **Format :** [description]
### Structure proposée
**Option A : [Nom descriptif]**
- [N] sections
- [M] modules au total
- Ressources : [liste]
**Option B : [Nom descriptif]**
- [N'] sections
- [M'] modules au total
- Ressources : [liste]
### Questions de raffinement
1. Quelle option préférez-vous ?
2. Avez-vous des ajustements dans les regroupements ?
3. Souhaitez-vous ajouter/supprimer des ressources ?
J'attends votre validation avant de continuer.
Étapes d'exécution
Étape 1 : Extraction des transcriptions
Adaptable selon l'entrée :
# Vidéo unique
python youtube_transcript.py "URL_VIDEO"
# Playlist (extraire d'abord la liste)
# Claude analyse la playlist et propose des regroupements
# Vidéos multiples
python youtube_transcript.py --batch liste_videos.txt
Étape 2 : Analyse et proposition
Claude analyse et propose (n'exécute pas encore) :
J'ai analysé les transcriptions et identifié :
- [X] sujets principaux
- [Y] sous-sujets
- Durée : [Z] heures
Proposition d'organisation :
[structure suggérée]
Puis-je continuer avec cette structure ?
Étape 3 : Création des données (après approbation)
Structure adaptative :
// Exemple : cours COURT (1 vidéo, 2h)
export const fases[Nom] = [
{ id: 1, nome: "Contenu complet", ... }
];
export const modulos[Nom] = [
{ id: '1.1', nome: 'Introduction', ... },
{ id: '1.2', nome: 'Concepts', ... },
{ id: '1.3', nome: 'Pratique', ... }
];
// Exemple : cours LONG (playlist de 50 vidéos)
export const fases[Nom] = [
{ id: 1, nome: "Fondamentaux", ... },
{ id: 2, nome: "Intermédiaire", ... },
{ id: 3, nome: "Avancé", ... },
{ id: 4, nome: "Spécialisation", ... },
{ id: 5, nome: "Projets", ... }
];
export const modulos[Nom] = [
// 50 modules organisés dans les 5 sections
];
Étape 4 : Transformation du contenu
Niveau de détail selon le besoin :
| Scénario | Détail | Composants |
|---|---|---|
| Cours court | Minimal | LearningSystem uniquement |
| Cours moyen | Standard | LearningSystem + NotesView basique |
| Cours long | Complet | LearningSystem + NotesView détaillé + Flashcards |
Étape 5 : Intégration
Toujours nécessaire :
- Mettre à jour
studyAreas.js - Mettre à jour
SistemaEducacionalCompleto.jsx
Optionnel selon le périmètre :
- Créer NotesView pour chaque module
- Créer des flashcards
- Créer des exercices
Modèles de transformation
Transformation basique (tout cours)
| Élément | JSX |
|---|---|
| Titre | <h2 className="text-2xl font-bold"> |
| Paragraphe | <p className="text-gray-700"> |
| Liste | <ul className="list-disc"> |
Transformation intermédiaire (cours moyens+)
| Élément | JSX |
|---|---|
| Code | <CodeBlock code={...}> |
| Avertissement | <div className="bg-yellow-50 border"> |
| Surbrillance | <div className="bg-[couleur]-100 p-4 rounded"> |
Transformation avancée (cours longs)
| Élément | JSX |
|---|---|
| Chronologie | Grille avec dates/événements |
| Comparaison | Grille 2 colonnes |
| Diagramme | Composant visuel personnalisé |
| Interactif | État React + gestionnaires |
Exemples par scénario
Scénario 1 : Vidéo courte (45 min)
ENTRÉE : "J'ai une vidéo de 45 min sur Git basique"
DIAGNOSTIC :
- Type : Vidéo unique courte
- Durée : < 1h
- Objectif : Introduction
PROPOSITION :
- 1 section unique
- 3-4 modules (Intro, Commandes, Branches, Pratique)
- Pas de flashcards (optionnel)
- Progression simple
RÉSULTAT :
├── gitLearningData.js (1 phase, 4 modules)
└── GitLearningSystem.jsx (composant simple)
Scénario 2 : Playlist moyenne (20 vidéos, 15h)
ENTRÉE : "Playlist Docker de 20 vidéos"
DIAGNOSTIC :
- Type : Playlist moyenne
- Durée : ~15h
- Objectif : Cours complet
PROPOSITION :
- 4 sections (Base, Images, Compose, Production)
- 20 modules (1 par vidéo)
- Flashcards par section
- Progression détaillée
RÉSULTAT :
├── dockerLearningData.js (4 phases, 20 modules)
├── DockerLearningSystem.jsx
├── DockerNotesView.jsx (4 fichiers, 1 par section)
└── Flashcards intégrés
Scénario 3 : Méga-playlist (100+ vidéos)
ENTRÉE : "Cours complet Python, 150 vidéos"
DIAGNOSTIC :
- Type : Très grande playlist
- Durée : 80h+
- Objectif : Formation complète
PROPOSITION INTERACTIVE :
"Ceci est un cours long. Je suggère de diviser en PARCOURS :
Parcours 1 : Python Basique (30 vidéos)
Parcours 2 : Python Intermédiaire (40 vidéos)
Parcours 3 : Python Avancé (40 vidéos)
Parcours 4 : Projets (40 vidéos)
Chaque parcours serait un 'cours' séparé dans le système.
Êtes-vous d'accord avec cette approche ?"
RÉSULTAT (après approbation) :
├── pythonBasicoLearningData.js
├── pythonIntermedLearningData.js
├── pythonAvancadoLearningData.js
├── pythonProjetosLearningData.js
└── Composants correspondants
Résolution de problèmes
Problème : Je ne sais pas combien de sections créer
Solution : Claude analyse et propose en fonction de :
- Changements de thème dans la transcription
- Durée relative des blocs
- Complexité du contenu
Problème : Les vidéos de la playlist sont très hétérogènes
Solution : Claude suggère des regroupements et demande validation :
"J'ai identifié 3 thèmes différents dans la playlist :
- Vidéos 1-8 : Fondamentaux
- Vidéos 9-15 : Applications
- Vidéos 16-20 : Avancé
Puis-je regrouper ainsi ou préférez-vous une autre organisation ?"
Problème : Contenu trop court pour une structure complète
Solution : Claude suggère une structure minimale :
"Avec seulement 30 minutes de contenu, je suggère :
- 1 module unique avec 3-4 sections internes
- Pas besoin de NotesView séparé
- Progression simple (terminé/non terminé)
Préférez-vous cette approche simplifiée ?"
Problème : Transcription non disponible
Solution : Claude propose des alternatives :
"La vidéo n'a pas de transcription automatique. Options :
1. Transcrire manuellement (vous fournissez le texte)
2. Utiliser un service externe de transcription
3. Créer une structure basée sur les titres/descriptions
4. Regarder et noter les sujets principaux
Que préférez-vous ?"
Références
Fichiers de référence
...