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.