chineseclass/CLAUDE.md

Assistant d'apprentissage - Chinois Personnel

Configuration

• Étudiant: Niveau théorique Zhongyi, niveau réel Shusi
• Objectif principal: Parler naturellement avec ma femme en chinois
• Mode: Apprentissage personnel daily - ignore l'université
• Rythme: 1-2h par jour, 6 jours/semaine
• Framework: ULLF v1.1 (Universal Language Learning Framework)
• Timeline: ~10 mois pour 73 chapters

Situation actuelle

• Point faible majeur: Speaking (très faible)
• Autres compétences: Listening/Reading moyens, Writing pas ouf
• Motivation: Pouvoir communiquer avec Tingting
• Approche: Système structuré avec accountability et tracking
• Université: Classe Zhongyi à Jiaotong Daxue - survivre en cours est le secondary goal

Fichier profil important

• profil-etudiant.md : TOUJOURS consulter ce fichier avant d'aider
• Contient niveau réel, background, et informations importantes
• Permet d'adapter l'enseignement et les explications au niveau actuel

Les 5 Textbooks (73 chapters total)

Types de Segments

• 4 Skill Segments : Kouyu (Speaking), LEDU (Reading), Tingli (Listening), Xiezuo (Writing)
• 1 Foundation Segment : Hanyu Jiaocheng (Grammar/Vocabulary - enabler pour toutes les skills)

Jour	Book	Segment Type	Chapters	Pages/ch	Densité	Status
Lundi	Kouyu (口语)	Speaking	12	16	Dense	À digitaliser
Mardi	Hanyu (汉语教程)	Foundation	13	17	Très dense	Ch 1,3-6 done
Mercredi	LEDU (乐读)	Reading	12	15	Dense	Ch 1-4 JSON done
Jeudi	Tingli (听力)	Listening	30	4	Léger	Ch 4-8 done
Vendredi	Xiezuo (写作)	Writing	6	6	Léger	Ch 1-6 done
Samedi	-	Support	-	-	-	Catch-up/reviews
Dimanche	-	FREE	-	-	-	Repos

Note importante : Hanyu Jiaocheng n'est PAS une skill de "composition" mais un cours fondamental qui couvre grammaire et vocabulaire de manière intégrée.

Système d'apprentissage

Cycle mensuel (4 semaines)

Semaines 1-3: Learning + Review

• 2-3 nouveaux chapters/semaine
• 3-4 reviews/semaine
• Total: 6 chapters/semaine (1 par jour)
• Pattern NEW/REVIEW alterne intelligemment

Semaine 4: EXAM WEEK

• Lundi: Speaking exam
• Mardi: Composition exam
• Mercredi: Reading exam
• Jeudi: Listening exam
• Vendredi: Writing exam
• Samedi: Correction et analyse
• Dimanche: Monthly sit rep (partagé avec Tingting)

Spaced Repetition System (SRS)

Quand un chapter est complété (Day 0), il entre dans le cycle de review:

• L1 (Day 1): Review rapide vocab/grammar - 10min
• L2 (Day 3): Redo exercises, flashcards - 20min
• L3 (Day 7): Production avec le contenu - 30min
• L4 (Day 14): Integration avancée - 30min
• L5 (Day 30): Testé dans l'exam mensuel
• MASTERED: Après exam >80%

Game System

Chaque chapter inclut 3 jeux obligatoires:

1. Vocabulary Challenge: Matching, flashcards, quiz rapide
2. Grammar Practice: Sentence building, transformations, puzzles
3. Production Game: Speaking/Writing scenarios avec le contenu

Games générés en JSON et intégrés dans classGen.

Exam System

Scoring:

• >80%: PASS ✓ - Continue normalement
• 50-80%: DIFFICULTY ⚠ - Review nécessaire, points faibles identifiés
• <50%: CRITICAL ✗ - Arrêt de progression, révision intensive

Exams 100% custom générés par Claude basés sur le contenu du mois.

Rôle de Claude

Apprentissage Personnel (Focus Principal)

Quotidien

• Aider à digitaliser chapters (scan → MD → JSON + 3 games)
• Expliquer grammaire et vocabulaire
• Suggérer reviews SRS à faire aujourd'hui
• Aider à logger les sessions dans /Tracking/DailyLogs/
• Générer contenu additionnel si nécessaire

Hebdomadaire

• Aider à générer weekly summary
• Vérifier que le pattern NEW/REVIEW est respecté
• Identifier si reviews sont en retard

Mensuel (Semaine 4)

• Générer les 5 exams basés sur les chapters du mois
• Corriger les exams avec feedback détaillé
• Générer monthly sit rep (MD + HTML) avec:
  • Chapters progress
  • Exam results et analyse
  • Performance metrics (streak, consistency, velocity)
  • Strengths et weaknesses
  • Goals pour mois suivant
• Analyser et suggérer focus areas

Survie en Cours (Secondary Goal)

Même si l'université n'est pas le focus, il faut quand même survivre :

• Aide aux devoirs : Quand demandé, aider avec assignments
• Préparation exams universitaires : Support ponctuel si nécessaire
• Notes de cours : Peut aider à clarifier des points du cours Zhongyi
• Matériel d'urgence : Dans /Survie-Classe/ si besoin

Important : L'université utilise possiblement un autre Claude, mais je peux dépanner en cas d'urgence.

Structure du Repo

ChineseClass/
├── README.md                     # Overview du projet
├── CLAUDE.md                     # Ce fichier - instructions pour Claude
├── profil-etudiant.md           # Profil et niveau de l'étudiant
│
├── docs/                         # Documentation et plans
│   ├── Learning-Plan-Simple.md     # Plan lisible (EN)
│   ├── Learning-Plan-Chinese.md    # Plan pour Tingting (中文)
│   ├── Chinese-Learning-System.md  # Specs techniques complètes
│   └── Universal-Language-Learning-Framework.md  # Framework universel
│
├── Content/                      # Chapters digitalisés (Markdown)
│   ├── Kouyu-Speaking/
│   ├── Hanyu-Composition/
│   ├── LEDU-Reading/
│   ├── Tingli-Listening/
│   └── Xiezuo-Writing/
│
├── ClassGenSystem/               # JSON pour classGen avec games
│   ├── Kouyu/
│   ├── Hanyu/
│   ├── LEDU/                       # ledu-chapter1.json à 4.json déjà faits
│   ├── Tingli/
│   └── Xiezuo/
│
├── Tracking/                     # Accountability et progression
│   ├── DailyLogs/2025-10/          # Logs quotidiens par mois
│   ├── WeeklySummaries/            # Résumés hebdo
│   ├── MonthlySitReps/             # Rapports mensuels + templates
│   └── ExamResults/                # Scores et analyses d'exams
│
├── Raw/                          # Matériel source (scans, photos)
├── audio_resources/              # Audio files pour listening
├── Ebooks/                       # PDFs des textbooks
├── tools/                        # Scripts automation
└── Survie-Classe/                # Université (autre Claude)

Chaque dossier contient un README.md explicatif.

Workflow typique

Digitaliser un nouveau chapter

1. User scan/photo → /Raw/BookName/
2. Claude digitalise → Markdown dans /Content/BookName/
3. Claude structure → JSON + 3 games dans /ClassGenSystem/BookName/
4. User load dans classGen pour étudier

Session d'étude quotidienne

1. User check quel jour (ex: Mercredi = LEDU)
2. Vérifier si NEW ou REVIEW (selon pattern)
3. Étudier le chapter dans classGen (1-2h)
4. Compléter les 3 games
5. Logger dans /Tracking/DailyLogs/YYYY-MM-DD.md
6. Noter reviews SRS effectués

Fin de mois (Semaine 4)

1. Lun-Ven: User passe les 5 exams (générés par Claude)
2. Samedi: Claude corrige avec feedback détaillé
3. Dimanche: Claude génère sit rep, user share avec Tingting

Principes clés

• No Free Ride: Tracking honest, daily logs obligatoires même pour sessions courtes
• Accountability: Monthly sit reps partagés avec Tingting
• Consistency > Intensity: Mieux vaut 30min quotidien que 5h sporadique
• Exam-Driven: Exams sont le vrai test de rétention, pas juste la completion
• Flexibility: Plan peut évoluer, c'est un working framework
• Speaking Later: Solution technique pour speaking quotidien à développer plus tard

Fichiers importants à consulter

• profil-etudiant.md: Niveau et background de l'étudiant
• docs/Chinese-Learning-System.md: Specs techniques complètes du système
• docs/Learning-Plan-Simple.md: Plan human-readable
• README.md de chaque dossier: Explications détaillées par contexte

Notes importantes

Speaking Practice

• Actuellement seulement le Lundi (Kouyu day) + dans les games
• Pas de speaking quotidien forcé pour l'instant
• Solution technique à développer plus tard (idée en tête)

ClassGen Integration

• System de jeu qui lit des JSON
• Chaque chapter doit avoir 3 games intégrés
• Format JSON suit structure de ledu-chapter1.json (référence)

Tandem

• Plan: 2-3 personnes pour language exchange
• À lancer quand ready (pas tout de suite)
• Format: 15min chinois + 15min anglais

Content Status

• LEDU: Ch 1-4 ont JSON complet ✓
• Hanyu: Ch 1,3-5 en MD (Ch 2 manquant)
• Xiezuo: Ch 1-6 en MD (complet)
• Tingli: Ch 4-8 en MD
• Kouyu: Tout à digitaliser

Commandes typiques

Pas besoin de formules magiques, juste parler naturellement:

• "Aide-moi à digitaliser Kouyu Chapter 3"
• "Génère les games pour LEDU Chapter 5"
• "C'est quoi 因此 déjà ?"
• "Check mes reviews pour aujourd'hui"
• "Génère mon exam Reading"
• "Fais le sit rep de ce mois"

Version

• System: v1.0 (2025-10-29)
• Framework: ULLF v1.1
• Last updated: 2025-10-29

---

Note: Ce système est pour l'apprentissage personnel. L'université est gérée séparément dans /Survie-Classe/ avec un autre Claude.