diff --git a/CLAUDE.md b/CLAUDE.md index 08a66ea..e4d3657 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,39 +1,237 @@ -# Assistant d'apprentissage - Jiaotong Daxue +# Assistant d'apprentissage - Chinois Personnel ## Configuration -- Étudiant: Classe Zhong yi (niveau en dessous - rattrapage nécessaire) -- Université: Jiaotong daxue -- Mode: **ULTRA INTENSIF** - rattrapage complet +- **É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 -## Plan de rattrapage -1. **Immersion totale** - notes détaillées de chaque cours -2. **Révisions quotidiennes** - 30min minimum par jour -3. **Exercices supplémentaires** - après chaque cours -4. **Vocabulaire intensif** - 20 nouveaux mots/jour minimum -5. **Support temps réel** - explications immédiates pendant les cours +## 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) + +| Jour | Book | Skill | Chapters | Pages/ch | Densité | Status | +|------|------|-------|----------|----------|---------|--------| +| **Lundi** | Kouyu (口语) | Speaking | 12 | 16 | Dense | À digitaliser | +| **Mardi** | Hanyu (汉语教程) | Composition | 13 | 17 | Très dense | Ch 1,3-5 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 | + +## 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 -- Assistant de prise de notes en temps réel -- Aide à la compréhension et révision -- Support pour exercices et devoirs -- Explications grammaticales et vocabulaire -## Structure des cours -Classe actuelle: **Zhong yi** -Autres classes: 4 autres à organiser +### Apprentissage Personnel (Focus Principal) -## Commandes utiles -- "Prendre notes": Pour débuter la prise de notes pendant le cours -- "Révision": Pour revoir les points importants -- "Exercice": Pour pratiquer -- "Vocabulaire": Pour travailler le lexique -- "Grammaire": Pour les explications grammaticales +**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 -## Fichiers importants -- **profil-etudiant.md** : Consulter pour adapter l'enseignement au niveau -- Toujours vérifier le profil avant les cours +**Hebdomadaire** +- Aider à générer weekly summary +- Vérifier que le pattern NEW/REVIEW est respecté +- Identifier si reviews sont en retard -## Organisation -- Dossier "Lecture & Ecriture" pour les notes de cours -- Fichiers par date de cours -- Système de révision progressive \ No newline at end of file +**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. diff --git a/CLAUDE.md.new b/CLAUDE.md.new new file mode 100644 index 0000000..37272d5 --- /dev/null +++ b/CLAUDE.md.new @@ -0,0 +1,122 @@ +# Assistant d'apprentissage - Chinois Daily + +## Mission +Aider à apprendre le chinois pour parler naturellement avec ta femme. +Framework : ULLF v1.1 + +--- + +## Mon Rôle + +### Quotidien +- Aider à digitaliser les chapters (MD → JSON + 3 games) +- Expliquer grammaire/vocabulaire +- Suggérer reviews SRS +- Aider à logger les sessions + +### Mensuel (Semaine 4) +- Générer les 5 exams (Speaking, Composition, Reading, Listening, Writing) +- Corriger avec feedback +- Générer monthly sit rep (MD + HTML) +- Analyser et suggérer focus + +--- + +## Le Système + +**5 Books, 73 chapters, ~10 mois** +- Lundi : Kouyu (口语) - 12 ch +- Mardi : Hanyu (汉语教程) - 13 ch +- Mercredi : LEDU (乐读) - 12 ch +- Jeudi : Tingli (听力) - 30 ch +- Vendredi : Xiezuo (写作) - 6 ch +- Samedi : Support/catch-up +- Dimanche : FREE + +**Cycle mensuel** +- Semaines 1-3 : 2-3 nouveaux + 3-4 reviews +- Semaine 4 : Exams + sit rep + +**SRS** : Reviews à Day 1, 3, 7, 14, 30 + +**Games** : 3 par chapter (Vocab, Grammar, Production) + +--- + +## Structure Repo + +``` +/docs/ → Plans et frameworks +/Content/ → Chapters en Markdown +/ClassGenSystem/ → JSON pour classGen avec games +/Tracking/ → Daily logs, weekly summaries, monthly sit reps, exam results +/Raw/ → Scans et photos source +/audio_resources/ → Audio files +/tools/ → Scripts automation +/Survie-Classe/ → Université (séparé, autre Claude) +``` + +Chaque dossier a un README.md qui explique tout. + +--- + +## Commandes Fréquentes + +**Contenu** +- "Digitalise [Book] Chapter X" +- "Génère les 3 games pour [Chapter]" +- "Explique [vocab/grammar]" + +**Tracking** +- "Check mes reviews SRS" +- "Génère weekly summary" +- "Aide-moi à logger" + +**Exams (Semaine 4)** +- "Génère exam [Skill]" +- "Corrige mon exam" +- "Génère sit rep" + +--- + +## Principes + +- **Accountability** : Daily logs + monthly sit reps shared avec Tingting +- **Consistency > Intensity** : 1-2h/jour, 6j/semaine +- **Exams pass à >80%** : 50-80% = difficulty, <50% = critical +- **No free rides** : Tracking honest +- **Flexibility** : Le plan peut changer + +--- + +## Important + +**Je NE fais PAS :** +- Coaching universitaire (→ Survie-Classe) +- Speaking quotidien forcé (solution technique à venir) +- Gamification excessive + +**Je FAIS :** +- Support technique +- Génération contenu + exams +- Tracking + sit reps +- Explications + +--- + +## Docs Clés + +- Root `/README.md` : Overview +- `/docs/Learning-Plan-Simple.md` : Plan lisible +- `/docs/Chinese-Learning-System.md` : Specs techniques +- Chaque dossier : README.md local + +--- + +## Status + +✅ Setup complet - Prêt à démarrer +⏳ Content à digitaliser +⏳ Games à générer +⏳ Exam frameworks à créer +⏳ Sit rep templates à créer diff --git a/CLAUDE.md.old b/CLAUDE.md.old new file mode 100644 index 0000000..08a66ea --- /dev/null +++ b/CLAUDE.md.old @@ -0,0 +1,39 @@ +# Assistant d'apprentissage - Jiaotong Daxue + +## Configuration +- Étudiant: Classe Zhong yi (niveau en dessous - rattrapage nécessaire) +- Université: Jiaotong daxue +- Mode: **ULTRA INTENSIF** - rattrapage complet + +## Plan de rattrapage +1. **Immersion totale** - notes détaillées de chaque cours +2. **Révisions quotidiennes** - 30min minimum par jour +3. **Exercices supplémentaires** - après chaque cours +4. **Vocabulaire intensif** - 20 nouveaux mots/jour minimum +5. **Support temps réel** - explications immédiates pendant les cours + +## Rôle de Claude +- Assistant de prise de notes en temps réel +- Aide à la compréhension et révision +- Support pour exercices et devoirs +- Explications grammaticales et vocabulaire + +## Structure des cours +Classe actuelle: **Zhong yi** +Autres classes: 4 autres à organiser + +## Commandes utiles +- "Prendre notes": Pour débuter la prise de notes pendant le cours +- "Révision": Pour revoir les points importants +- "Exercice": Pour pratiquer +- "Vocabulaire": Pour travailler le lexique +- "Grammaire": Pour les explications grammaticales + +## Fichiers importants +- **profil-etudiant.md** : Consulter pour adapter l'enseignement au niveau +- Toujours vérifier le profil avant les cours + +## Organisation +- Dossier "Lecture & Ecriture" pour les notes de cours +- Fichiers par date de cours +- Système de révision progressive \ No newline at end of file diff --git a/ClassGenSystem/README.md b/ClassGenSystem/README.md new file mode 100644 index 0000000..813deb7 --- /dev/null +++ b/ClassGenSystem/README.md @@ -0,0 +1,89 @@ +# ClassGenSystem - Game-Ready JSON Content + +This folder contains all textbook content structured as JSON files ready to be loaded into the classGen game system. + +## Structure + +Each book has its own subfolder with JSON files: + +``` +ClassGenSystem/ +├── Kouyu/ # Speaking chapters as JSON +├── Hanyu/ # Composition chapters as JSON +├── LEDU/ # Reading chapters as JSON +├── Tingli/ # Listening chapters as JSON +└── Xiezuo/ # Writing chapters as JSON +``` + +## JSON Format + +Each chapter JSON includes: +- **Metadata**: id, name, difficulty, estimated hours, prerequisites +- **Vocabulary**: Words with pronunciation, type, meaning, examples +- **Grammar**: Patterns with explanations and examples +- **Texts**: Main reading/listening content with questions +- **Exercises**: Various exercise types (character inference, comprehension, etc.) +- **Games**: 3 games per chapter + - Game 1: Vocabulary challenge + - Game 2: Grammar/pattern practice + - Game 3: Production game + +## Game Structure + +Each chapter must have 3 games: + +```json +"games": [ + { + "id": "game1-vocab", + "type": "vocabulary-matching", + "title": "Vocabulary Challenge", + "data": { /* game-specific data */ } + }, + { + "id": "game2-grammar", + "type": "sentence-builder", + "title": "Grammar Practice", + "data": { /* game-specific data */ } + }, + { + "id": "game3-production", + "type": "speaking-challenge", + "title": "Production Game", + "data": { /* game-specific data */ } + } +] +``` + +## Workflow + +``` +Markdown content (Content/) + → Structure as JSON with metadata + → Add 3 games per chapter + → Save here (ClassGenSystem/) + → Load into classGen app +``` + +## Current Status + +| Book | JSON Files | Status | +|------|------------|--------| +| **LEDU** | Chapters 1-4 | ✓ Exists with full structure | +| **Hanyu** | 0/13 | Need to create | +| **Kouyu** | 0/12 | Need to create | +| **Tingli** | 0/30 | Need to create | +| **Xiezuo** | 0/6 | Need to create | + +## Reference + +See `ledu-chapter1.json` for a complete example of proper JSON structure. + +Book metadata file: `ledu-book.json` shows how to structure a book overview. + +## Notes + +- Follow the LEDU format for consistency +- Each game should be playable and engaging +- Vocabulary should include pronunciation (pinyin) and examples +- Grammar patterns need clear explanations and multiple examples diff --git a/Content/Hanyu-Composition/README.md b/Content/Hanyu-Composition/README.md new file mode 100644 index 0000000..45e97d4 --- /dev/null +++ b/Content/Hanyu-Composition/README.md @@ -0,0 +1,51 @@ +# Hanyu Jiaocheng (汉语教程) - Composition + +**Book**: 汉语教程 (Chinese Course) +**Skill**: Composition and comprehensive Chinese +**Total Chapters**: 13 +**Pages per Chapter**: ~17 +**Density**: Very dense (longest chapters) +**Current Status**: Chapters 1, 3-5 digitized (missing Chapter 2) + +## Overview + +The Hanyu Jiaocheng book is the most comprehensive textbook, focusing on structured composition, grammar patterns, and integrated language skills. Each chapter typically includes: +- Main text with complex grammar +- Comprehensive vocabulary +- Grammar explanations and patterns +- Composition exercises +- Cultural content + +## Chapter List + +- [x] Chapter 01 - 离家的时候 (At the Moment of Leaving Home) +- [ ] Chapter 02 - [Missing - need to digitize] +- [x] Chapter 03 - [Title TBD] +- [x] Chapter 04 - [Title TBD] +- [x] Chapter 05 - [Title TBD] +- [ ] Chapter 06 - [To digitize] +- [ ] Chapter 07 - [To digitize] +- [ ] Chapter 08 - [To digitize] +- [ ] Chapter 09 - [To digitize] +- [ ] Chapter 10 - [To digitize] +- [ ] Chapter 11 - [To digitize] +- [ ] Chapter 12 - [To digitize] +- [ ] Chapter 13 - [To digitize] + +## Schedule + +**Day of Week**: Tuesday +**Study Type**: Composition and comprehensive grammar + +## Source Material + +- Digitized files in: `Content/Hanyu-Jiaocheng-MD/` +- There's also a `Hanyu-Jiaocheng-Chapter2.md` in Content/ root +- Raw materials in: `Raw/Hanyu Jiaocheng/` + +## Notes + +- Longest and most dense book (17 pages per chapter) +- These chapters will take more time than others +- Strong grammar foundation - important for other skills +- Need to organize existing files and continue digitizing diff --git a/Content/Kouyu-Speaking/README.md b/Content/Kouyu-Speaking/README.md new file mode 100644 index 0000000..b1f8eed --- /dev/null +++ b/Content/Kouyu-Speaking/README.md @@ -0,0 +1,48 @@ +# Kouyu (口语) - Speaking + +**Book**: Kouyu (Oral Chinese) +**Skill**: Speaking +**Total Chapters**: 12 +**Pages per Chapter**: ~16 +**Density**: Dense +**Current Status**: To digitize + +## Overview + +The Kouyu book focuses on spoken Chinese, dialogues, and conversational skills. Each chapter typically includes: +- Dialogue scenarios +- Common speaking patterns +- Pronunciation practice +- Conversational exercises +- Speaking activities + +## Chapter List + +- [ ] Chapter 01 - [Title TBD] +- [ ] Chapter 02 - [Title TBD] +- [ ] Chapter 03 - [Title TBD] +- [ ] Chapter 04 - [Title TBD] +- [ ] Chapter 05 - [Title TBD] +- [ ] Chapter 06 - [Title TBD] +- [ ] Chapter 07 - [Title TBD] +- [ ] Chapter 08 - [Title TBD] +- [ ] Chapter 09 - [Title TBD] +- [ ] Chapter 10 - [Title TBD] +- [ ] Chapter 11 - [Title TBD] +- [ ] Chapter 12 - [Title TBD] + +## Schedule + +**Day of Week**: Monday +**Study Type**: Speaking practice with chapter content + +## Source Material + +Raw scans/photos located in: `Raw/Kouyu/` + +## Next Steps + +1. Scan/photograph all chapters +2. Digitize to Markdown format +3. Extract vocabulary and dialogue +4. Create JSON for classGen with 3 games per chapter diff --git a/Content/LEDU-Chapitre4.md b/Content/LEDU-Chapitre4.md index fff4cec..b2d7c2d 100644 --- a/Content/LEDU-Chapitre4.md +++ b/Content/LEDU-Chapitre4.md @@ -163,40 +163,111 @@ Méthode pour raccourcir des expressions longues : --- ## 📚 Texte secondaire : 环保小贴士 (Conseils écologiques) +**Huánbǎo xiǎo tiēshì** + +### Introduction + +随着城市的发展，环境污染问题也在加重。 +*Suízhe chéngshì de fāzhǎn, huánjìng wūrǎn wèntí yě zài jiāzhòng.* +> Avec le développement des villes, les problèmes de pollution de l'environnement s'aggravent. + +人们在抱怨城市空气越来越糟糕的同时，也应意识到环境的保护和每个人的生活方式息息相关。 +*Rénmen zài bàoyuàn chéngshì kōngqì yuèláiyuè zāogāo de tóngshí, yě yīng yìshí dào huánjìng de bǎohù hé měi gè rén de shēnghuó fāngshì xīxī xiāngguān.* +> Pendant que les gens se plaignent que l'air de la ville devient de plus en plus mauvais, ils devraient aussi réaliser que la protection de l'environnement est étroitement liée au mode de vie de chacun. + +下面是生活中可以随手做到的几件环保小事。 +*Xiàmiàn shì shēnghuó zhōng kěyǐ suíshǒu zuò dào de jǐ jiàn huánbǎo xiǎoshì.* +> Voici quelques petites choses écologiques qu'on peut facilement faire au quotidien. + +--- ### Les 10 petits gestes écologiques au quotidien -1. **随手关水龙头** - Fermer les robinets - - Ne pas laisser couler l'eau en se lavant les mains, se douchant, lavant les vêtements +**一、随手关水龙头，不要一直开着水龙头洗手、洗澡、洗衣服。** +*Yī, suíshǒu guān shuǐlóngtóu, bùyào yīzhí kāizhe shuǐlóngtóu xǐshǒu, xǐzǎo, xǐ yīfu.* +> 1. Fermer les robinets en passant, ne pas laisser couler l'eau en permanence quand on se lave les mains, qu'on se douche ou qu'on lave les vêtements. -2. **随手关灯** - Éteindre les lumières - - Chaque kWh économisé réduit les gaz nocifs dans l'air +**二、随手关灯，这不只是为了节约电费，每节约一度电，空气中就会减少很多有害的气体。** +*Èr, suíshǒu guān dēng, zhè bù zhǐ shì wèile jiéyuē diànfèi, měi jiéyuē yī dù diàn, kōngqì zhōng jiù huì jiǎnshǎo hěnduō yǒuhài de qìtǐ.* +> 2. Éteindre les lumières en passant, ce n'est pas seulement pour économiser l'électricité, chaque kilowatt-heure économisé réduit beaucoup de gaz nocifs dans l'air. -3. **réutiliser l'eau** - Réutiliser l'eau - - L'eau de lessive peut servir à nettoyer le sol ou tirer la chasse +**三、重复使用水，洗衣服后的水可以擦地或冲厕所等。** +*Sān, chóngfù shǐyòng shuǐ, xǐ yīfu hòu de shuǐ kěyǐ cā dì huò chōng cèsuǒ děng.* +> 3. Réutiliser l'eau, l'eau de lessive peut servir à nettoyer le sol ou à tirer la chasse d'eau, etc. -4. **不用塑料袋** - Ne pas utiliser de sacs plastiques - - Apporter ses propres sacs pour faire les courses +**四、买东西时不用塑料袋，出门购物带上自备的袋子。** +*Sì, mǎi dōngxi shí bùyòng sùliào dài, chūmén gòuwù dài shàng zìbèi de dàizi.* +> 4. Ne pas utiliser de sacs plastiques quand on fait des achats, apporter ses propres sacs quand on sort faire les courses. -5. **不食用野生动物** - Ne pas consommer d'animaux sauvages - - Ne pas porter de vêtements en fourrure d'animaux sauvages +**五、不食用野生动物，不穿野生动物毛皮做的衣服。** +*Wǔ, bù shíyòng yěshēng dòngwù, bù chuān yěshēng dòngwù máopí zuò de yīfu.* +> 5. Ne pas consommer d'animaux sauvages, ne pas porter de vêtements faits en fourrure d'animaux sauvages. -6. **选购绿色食品** - Choisir des aliments verts - - Acheter des fruits et légumes sans pesticides +**六、选购不用农药的新鲜果蔬，买包装上有"绿色食品"标识的食品。** +*Liù, xuǎngòu bùyòng nóngyào de xīnxiān guǒshū, mǎi bāozhuāng shàng yǒu "lǜsè shípǐn" biāoshí de shípǐn.* +> 6. Choisir des fruits et légumes frais sans pesticides, acheter des aliments avec le label "aliments verts" sur l'emballage. -7. **多用公共交通** - Utiliser davantage les transports publics - - Économiser l'essence et réduire la pollution de l'air +**七、多用公共交通工具，这样既可以节约汽油，又可以减少汽车尾气带来的空气污染。** +*Qī, duō yòng gōnggòng jiāotōng gōngjù, zhèyàng jì kěyǐ jiéyuē qìyóu, yòu kěyǐ jiǎnshǎo qìchē wěiqì dàilái de kōngqì wūrǎn.* +> 7. Utiliser davantage les transports publics, ainsi on peut à la fois économiser l'essence et réduire la pollution de l'air causée par les gaz d'échappement. -8. **公共场所不吸烟** - Ne pas fumer dans les lieux publics - - Dans les espaces publics, lieux de travail intérieurs, transports publics +**八、公共场所、室内工作场所、公共交通工具内不吸烟。** +*Bā, gōnggòng chǎngsuǒ, shìnèi gōngzuò chǎngsuǒ, gōnggòng jiāotōng gōngjù nèi bù xīyān.* +> 8. Ne pas fumer dans les lieux publics, les lieux de travail intérieurs et les transports publics. -9. **垃圾分类** - Trier les déchets - - Séparer les différents types de déchets - - Les déchets triés = ressources utiles - - Les déchets mélangés = pollution du sol et de l'air +**九、做好垃圾分类，不同种类的垃圾分开放。** +*Jiǔ, zuò hǎo lājī fēnlèi, bùtóng zhǒnglèi de lājī fēnkāi fàng.* +> 9. Bien trier les déchets, séparer les différents types de déchets. -10. **照顾一棵树** - S'occuper d'un arbre - - L'arroser régulièrement, le considérer comme un membre de la famille +分装垃圾是把垃圾当作有用的资源，混装的垃圾会污染土地和空气。 +*Fēnzhuāng lājī shì bǎ lājī dàngzuò yǒuyòng de zīyuán, hùnzhuāng de lājī huì wūrǎn tǔdì hé kōngqì.* +> Trier les déchets, c'est traiter les déchets comme des ressources utiles, les déchets mélangés pollueront le sol et l'air. + +**十、照顾附近的一棵树，定期给它浇水，把它当作家庭里的一员。** +*Shí, zhàogù fùjìn de yī kē shù, dìngqī gěi tā jiāo shuǐ, bǎ tā dàngzuò jiātíng lǐ de yī yuán.* +> 10. S'occuper d'un arbre à proximité, l'arroser régulièrement, le considérer comme un membre de la famille. + +--- + +### Vocabulaire supplémentaire du texte secondaire + +| Caractères | Pinyin | Type | Français | +|-----------|--------|------|----------| +| 息息相关 | xīxī xiāngguān | Expr | étroitement lié | +| 随手 | suíshǒu | Adv | en passant, facilement | +| 塑料袋 | sùliào dài | N | sac plastique | +| 野生动物 | yěshēng dòngwù | N | animaux sauvages | +| 绿色食品 | lǜsè shípǐn | N | aliments verts/bio | +| 垃圾分类 | lājī fēnlèi | N | tri des déchets | +| 抱怨 | bàoyuàn | V | se plaindre | +| 糟糕 | zāogāo | Adj | terrible, mauvais | +| 节约 | jiéyuē | V | économiser | +| 加重 | jiāzhòng | V | s'aggraver | +| 水龙头 | shuǐlóngtóu | N | robinet | +| 电费 | diànfèi | N | facture d'électricité | +| 度 | dù | M | kilowatt-heure (kWh) | +| 气体 | qìtǐ | N | gaz | +| 重复 | chóngfù | V | répéter, réutiliser | +| 擦地 | cā dì | VP | nettoyer le sol | +| 冲厕所 | chōng cèsuǒ | VP | tirer la chasse | +| 自备 | zìbèi | V | apporter soi-même | +| 食用 | shíyòng | V | consommer (nourriture) | +| 毛皮 | máopí | N | fourrure | +| 农药 | nóngyào | N | pesticide | +| 果蔬 | guǒshū | N | fruits et légumes | +| 标识 | biāoshí | N | label, marque | +| 汽油 | qìyóu | N | essence | +| 尾气 | wěiqì | N | gaz d'échappement | +| 室内 | shìnèi | N | intérieur | +| 吸烟 | xīyān | VO | fumer | +| 种类 | zhǒnglèi | N | type, sorte | +| 分装 | fēnzhuāng | V | trier, séparer | +| 混装 | hùnzhuāng | V | mélanger | +| 土地 | tǔdì | N | terre, sol | +| 照顾 | zhàogù | V | s'occuper de | +| 定期 | dìngqī | Adv | régulièrement | +| 浇水 | jiāo shuǐ | VO | arroser | +| 一员 | yī yuán | N | un membre | --- diff --git a/Content/LEDU-Reading/README.md b/Content/LEDU-Reading/README.md new file mode 100644 index 0000000..adad562 --- /dev/null +++ b/Content/LEDU-Reading/README.md @@ -0,0 +1,48 @@ +# LEDU (乐读) - Reading + +**Book**: 乐读 (Lè dú) - Chinese Reading Course +**Skill**: Reading +**Total Chapters**: 12 +**Pages per Chapter**: ~15 +**Density**: Dense +**Current Status**: Chapters 1-4 in JSON, more to digitize + +## Overview + +The LEDU book focuses on reading comprehension, vocabulary acquisition, and cultural understanding through authentic Chinese texts. Each chapter typically includes: +- Main reading texts +- Vocabulary with examples +- Character inference exercises +- Reading comprehension questions +- Cultural notes + +## Chapter List + +- [x] Chapter 01 - 民以食为天 (Food is Heaven for the People) +- [x] Chapter 02 - [Title TBD] +- [x] Chapter 03 - 生命在于运动 (Life Lies in Movement) +- [x] Chapter 04 - [Title TBD] +- [x] Chapter 05 - [Title TBD] +- [ ] Chapter 06 - [Title TBD] +- [ ] Chapter 07 - [Title TBD] +- [ ] Chapter 08 - [Title TBD] +- [ ] Chapter 09 - [Title TBD] +- [ ] Chapter 10 - [Title TBD] +- [ ] Chapter 11 - [Title TBD] +- [ ] Chapter 12 - [Title TBD] + +## Schedule + +**Day of Week**: Wednesday +**Study Type**: Reading comprehension and vocabulary + +## Source Material + +- Raw scans located in: `Raw/LEDU/` +- Existing JSON: `ClassGenSystem/ledu-chapter1.json` through `ledu-chapter4.json` + +## Notes + +- Chapters 1-4 already have structured JSON with vocabulary, grammar, texts, and exercises +- Need to continue digitizing remaining chapters +- Follow same JSON structure for consistency diff --git a/Content/README.md b/Content/README.md new file mode 100644 index 0000000..e9b762e --- /dev/null +++ b/Content/README.md @@ -0,0 +1,64 @@ +# Content - Digitized Textbook Materials + +This folder contains all textbook content converted to Markdown format for easy reading, editing, and processing. + +## Structure + +Each skill has its own subfolder with digitized chapters: + +``` +Content/ +├── Kouyu-Speaking/ # 口语 - 12 chapters, 16 pages each +├── Hanyu-Composition/ # 汉语教程 - 13 chapters, 17 pages each +├── LEDU-Reading/ # 乐读 - 12 chapters, 15 pages each +├── Tingli-Listening/ # 听力 - 30 chapters, 4 pages each +└── Xiezuo-Writing/ # 写作 - 6 chapters, 6 pages each +``` + +## File Naming Convention + +Chapters should be named consistently: +``` +ChapterXX-Title.md +``` + +Examples: +- `Chapter01-Mon-Apprentissage-du-Chinois.md` +- `Chapter03-Life-in-Movement.md` +- `Chapitre4-Why-Worry.md` + +## Content Format + +Each Markdown file should include: +- Chapter title (Chinese + translation) +- Vocabulary section with pinyin and meanings +- Grammar points +- Main text(s) +- Exercises +- Any notes or examples + +## Workflow + +``` +Raw material (PDF/scan) + → Digitize to Markdown (this folder) + → Structure as JSON with games (ClassGenSystem/) + → Load into classGen for study +``` + +## Status by Book + +| Book | Chapters | Status | Location | +|------|----------|--------|----------| +| **Kouyu** | 0/12 | To digitize | Raw/Kouyu/ | +| **Hanyu** | 5/13 | Partial | Hanyu-Composition/ | +| **LEDU** | 3/12 | Partial | LEDU-Reading/ | +| **Tingli** | 5/30 | Partial | Tingli-Listening/ | +| **Xiezuo** | 6/6 | Complete | Xiezuo-Writing/ | + +## Notes + +- Keep original formatting as much as possible +- Include audio references where applicable +- Mark any unclear or missing content with `[?]` +- Preserve Chinese characters, pinyin, and translations diff --git a/Content/Tingli-Listening/README.md b/Content/Tingli-Listening/README.md new file mode 100644 index 0000000..7945710 --- /dev/null +++ b/Content/Tingli-Listening/README.md @@ -0,0 +1,49 @@ +# Tingli (听力) - Listening + +**Book**: Develop Chinese - Listening (听力) +**Skill**: Listening Comprehension +**Total Chapters**: 30 +**Pages per Chapter**: ~4 +**Density**: Light (but many chapters) +**Current Status**: Chapters 4-8 digitized + +## Overview + +The Tingli book focuses on listening comprehension through audio materials and transcripts. Each chapter typically includes: +- Listening exercises +- Comprehension questions +- Vocabulary from audio +- Transcripts (sometimes) +- Dictation practice + +## Chapter List (Partial) + +- [ ] Chapter 01 - [Title TBD] +- [ ] Chapter 02 - [Title TBD] +- [ ] Chapter 03 - [Title TBD] +- [x] Chapter 04 - 为什么烦恼 (Why Worry) +- [x] Chapter 05 - Audio Transcription + Beggar Story +- [x] Chapter 06 - 20 Dollars +- [x] Chapter 07 - 不要活得太累 (Don't Live Too Tired) +- [x] Chapter 08 - Age Not Important +- [ ] Chapters 09-30 - [To digitize] + +## Schedule + +**Day of Week**: Thursday +**Study Type**: Listening comprehension with audio + +## Audio Resources + +Audio files located in: `audio_resources/intermediate_listening_1/` + +## Source Material + +Raw materials in: `Raw/DevelopChinese/` + +## Notes + +- Short chapters (4 pages) make these faster to complete +- Audio is essential - always link audio files +- More chapters than other books but lighter content +- Good for frequent NEW chapters in the rotation diff --git a/Content/Xiezuo-Writing/README.md b/Content/Xiezuo-Writing/README.md new file mode 100644 index 0000000..75cc8c9 --- /dev/null +++ b/Content/Xiezuo-Writing/README.md @@ -0,0 +1,43 @@ +# Xiezuo (写作) - Writing + +**Book**: 写作 (Writing) +**Skill**: Written composition and essays +**Total Chapters**: 6 +**Pages per Chapter**: ~6 +**Density**: Light +**Current Status**: All 6 chapters digitized ✓ + +## Overview + +The Xiezuo book focuses on structured writing, essay composition, and written expression. Each chapter typically includes: +- Writing prompts and topics +- Model texts +- Vocabulary for writing +- Writing exercises +- Composition practice + +## Chapter List + +- [x] Chapter 01 - 我的汉语学习经历 (My Chinese Learning Experience) +- [x] Chapter 02 - 请假申请 (Leave Request) +- [x] Chapter 03 - 我的愿望 (My Wish) +- [x] Chapter 04 - 餐厅评价 (Restaurant Evaluation) +- [x] Chapter 05 - [Title TBD] +- [x] Chapter 06 - 中国节日 (Chinese Festivals) + +## Schedule + +**Day of Week**: Friday +**Study Type**: Writing practice and composition + +## Source Material + +Digitized files currently in: `Content/Composition/` +Should be moved/organized here for consistency + +## Notes + +- Shortest book (only 6 chapters) +- All chapters already digitized - just need to organize +- Good for quick study sessions +- Will cycle through reviews more than new content diff --git a/Ebooks/README.md b/Ebooks/README.md new file mode 100644 index 0000000..3dd9209 --- /dev/null +++ b/Ebooks/README.md @@ -0,0 +1,36 @@ +# Ebooks + +PDF versions of textbooks and reference materials. + +## Purpose + +This folder stores: +- PDF textbooks (if available digitally) +- Reference books +- Grammar guides +- Dictionary files +- Any other ebook resources for Chinese learning + +## Organization + +Organize by type: +``` +Ebooks/ +├── Textbooks/ # The 5 main books if available as PDFs +├── Reference/ # Grammar guides, dictionaries, etc. +└── Supplementary/ # Additional learning materials +``` + +## Usage + +These serve as: +- Quick reference during study +- Source for scanning/digitizing if needed +- Backup of textbook content +- Searchable text (if OCR'd) + +## Notes + +- Keep original filenames for easy identification +- If creating PDFs from scans, use OCR for searchability +- Add a text file listing all ebooks with descriptions diff --git a/README.md b/README.md new file mode 100644 index 0000000..10fbde7 --- /dev/null +++ b/README.md @@ -0,0 +1,87 @@ +# ChineseClass - Personal Chinese Learning System + +My systematic approach to learning Chinese, with the goal of having natural conversations with my wife. + +## Overview + +This repository contains my complete Chinese learning system based on the Universal Language Learning Framework (ULLF). I'm working through 5 intermediate Chinese textbooks (73 chapters total) with a structured daily routine, spaced repetition, monthly exams, and game-based learning. + +**Target**: Speak fluently with my wife in Chinese +**Timeline**: 10-12 months +**Pace**: ~9 new chapters per month +**Daily commitment**: 1-2 hours, 6 days per week + +## Quick Links + +- **[Learning Plan (English)](docs/Learning-Plan-Simple.md)** - Simple, human-readable plan +- **[学习计划（中文）](docs/Learning-Plan-Chinese.md)** - Chinese version for my wife +- **[Technical System](docs/Chinese-Learning-System.md)** - Detailed technical documentation +- **[Framework](docs/Universal-Language-Learning-Framework.md)** - Universal framework (works for any language) + +## Project Structure + +``` +ChineseClass/ +├── docs/ # Plans and documentation +├── Content/ # Digitized textbook content (Markdown) +├── ClassGenSystem/ # Game-ready JSON for classGen +├── Tracking/ # Daily logs, exams, monthly reports +├── Raw/ # Scans and source materials +├── audio_resources/ # Audio files for listening practice +├── Ebooks/ # PDF textbooks +├── tools/ # Scripts and utilities +└── Survie-Classe/ # University survival materials (separate) +``` + +See individual README.md files in each folder for details. + +## The 5 Books + +| Book | Skill | Chapters | Status | +|------|-------|----------|--------| +| **Kouyu (口语)** | Speaking | 12 | To digitize | +| **Hanyu (汉语教程)** | Composition | 13 | Chapters 1-5 done | +| **LEDU (乐读)** | Reading | 12 | Chapters 1-4 in JSON | +| **Tingli (听力)** | Listening | 30 | Chapters 4-8 done | +| **Xiezuo (写作)** | Writing | 6 | Chapters 1-6 done | + +**Total**: 73 chapters, ~749 pages + +## Weekly Schedule + +- **Monday**: Speaking (Kouyu) +- **Tuesday**: Composition (Hanyu) +- **Wednesday**: Reading (LEDU) +- **Thursday**: Listening (Tingli) +- **Friday**: Writing (Xiezuo) +- **Saturday**: Support day (catch-up, reviews) +- **Sunday**: Free day + +## Monthly Cycle + +- **Weeks 1-3**: Learning (2-3 new chapters) + Reviews (3-4 chapters) +- **Week 4**: Exam week + Monthly sit rep + +## Key Features + +- **Spaced Repetition System**: Reviews at Day 1, 3, 7, 14, 30 +- **Game-Based Learning**: 3 games per chapter (vocabulary, grammar, production) +- **Monthly Accountability**: Exams + reports shared with my wife +- **Flexible Schedule**: Saturday for catch-up, Sunday free +- **No Decision Fatigue**: Same routine every week + +## Current Status + +- Framework designed ✓ +- Documentation complete ✓ +- Folder structure setup ✓ +- Ready to start learning! + +## Version + +- System: v1.0 (2025-10-29) +- Framework: ULLF v1.1 + +--- + +*This plan might change with time but that's my working framework at least.* diff --git a/Raw/README.md b/Raw/README.md new file mode 100644 index 0000000..1b82ff3 --- /dev/null +++ b/Raw/README.md @@ -0,0 +1,47 @@ +# Raw Materials + +This folder contains all source materials: scans, photos, PDFs, and any unprocessed content from the textbooks. + +## Structure + +``` +Raw/ +├── Kouyu/ # Speaking book materials +├── Hanyu Jiaocheng/ # Composition book materials +├── LEDU/ # Reading book materials +├── DevelopChinese/ # Listening book materials (Tingli) +├── Xiezuo/ # Writing book materials +└── Femme/ # Materials from wife (if any) +``` + +## Purpose + +This is the staging area before digitization. Keep original scans and photos here so they can be: +- Referenced if digitized version is unclear +- Re-scanned if needed +- Backed up as originals +- Processed into Markdown (Content/) and JSON (ClassGenSystem/) + +## Workflow + +``` +Physical textbook + → Scan/photograph → Raw/ (this folder) + → Digitize → Content/ (Markdown) + → Structure → ClassGenSystem/ (JSON with games) + → Study → classGen app +``` + +## File Organization + +Within each book folder: +- Keep chapter-by-chapter if possible +- Name files clearly: `Chapter01-page1.jpg`, `Chapter01-page2.jpg`, etc. +- If full PDFs, name them: `BookName-Full.pdf` + +## Notes + +- Don't edit files here - this is the "source of truth" +- If you discover errors in digitized content, check here first +- High-quality scans make digitization easier +- Keep originals even after digitization is complete diff --git a/Survie-Classe/README.md b/Survie-Classe/README.md new file mode 100644 index 0000000..8571b66 --- /dev/null +++ b/Survie-Classe/README.md @@ -0,0 +1,30 @@ +# Survie-Classe + +Materials for surviving university classes - separate from personal learning system. + +## Purpose + +This folder is for: +- Class notes from university +- Homework and assignments +- Exam preparation for school exams +- Materials specifically for passing the course + +## Distinction + +**This is NOT part of the main learning system.** + +The main system (Content/, ClassGenSystem/, Tracking/) is for personal learning at your own pace with the goal of speaking with your wife. + +Survie-Classe is for university survival - a different goal with different methods. + +## Usage + +- Keep university materials here +- Don't mix with personal learning tracking +- Handle this with a separate Claude instance if needed +- Focus is on passing exams, not long-term retention + +## Note + +The personal learning system ignores the university and focuses on real mastery. This folder is just a backup for school stuff. diff --git a/Tracking/DailyLogs/README.md b/Tracking/DailyLogs/README.md new file mode 100644 index 0000000..f118d4b --- /dev/null +++ b/Tracking/DailyLogs/README.md @@ -0,0 +1,55 @@ +# Daily Logs + +Daily study logs organized by month. + +## Format + +Each log is a Markdown file named `YYYY-MM-DD.md` + +## Template + +```markdown +# Daily Log - [YYYY-MM-DD] + +## Session Info +- **Day of Week**: [Monday-Sunday] +- **Skill Focus**: [Speaking|Composition|Reading|Listening|Writing|Support] +- **Time Spent**: Xh Ymin +- **Streak**: X days + +## Chapter Work +- **Chapter**: [book-name] Chapter X +- **Type**: [NEW|REVIEW-L1|REVIEW-L2|REVIEW-L3|REVIEW-L4] +- **Progress**: X% +- **Games Completed**: X/3 + +## Additional Reviews +- Chapter Y (L1) - 10min +- Chapter Z (L2) - 20min + +## Notes & Observations +- **What went well**: ... +- **Difficulties encountered**: ... +- **Tomorrow's focus**: ... + +## Vocabulary Learned +- 词语 (cíyǔ) - word, vocabulary +- [other new vocab] +``` + +## Usage + +1. Copy template for each day +2. Fill in as you study +3. Be honest - even short sessions count +4. Track streak carefully +5. Note difficulties for later focus + +## Organization + +Logs are organized by month: +- `2025-10/` - October 2025 +- `2025-11/` - November 2025 +- etc. + +This keeps the folder manageable and makes it easy to review a specific month. diff --git a/Tracking/ExamResults/README.md b/Tracking/ExamResults/README.md new file mode 100644 index 0000000..245df55 --- /dev/null +++ b/Tracking/ExamResults/README.md @@ -0,0 +1,62 @@ +# Exam Results + +Storage for all monthly exam results and analysis. + +## Format + +Each monthly exam set gets a folder: `YYYY-MM-MonthName/` + +Inside each folder: +- `Speaking-Exam.md` - Full exam + score +- `Composition-Exam.md` - Full exam + score +- `Reading-Exam.md` - Full exam + score +- `Listening-Exam.md` - Full exam + score +- `Writing-Exam.md` - Full exam + score +- `Summary.md` - Overview of all 5 exams + +## Scoring + +Each exam is scored /100 with status: +- **>80%**: PASS ✓ - Continue normally +- **50-80%**: DIFFICULTY ⚠ - Review needed, identify weak points +- **<50%**: CRITICAL ✗ - Stop progression, intensive review required + +## Exam Week Schedule + +- **Monday**: Speaking (Kouyu) +- **Tuesday**: Composition (Hanyu) +- **Wednesday**: Reading (LEDU) +- **Thursday**: Listening (Tingli) +- **Friday**: Writing (Xiezuo) +- **Saturday**: Grading and analysis +- **Sunday**: Sit rep generation + +## Purpose + +Exam results serve to: +- Measure actual retention and mastery +- Identify which skills need more focus +- Track improvement over time +- Provide accountability +- Inform next month's study plan + +## Exam Frameworks + +Detailed exam structures for each skill type are documented in: +`docs/Exam-Frameworks.md` (to be created) + +## Analysis + +At the end of each exam period, analyze: +- Which skill scored highest/lowest +- Common error patterns +- Vocabulary vs grammar performance +- Comprehension vs production +- Trends compared to previous months + +## Notes + +- Exams are 100% custom generated based on that month's content +- No shortcuts - be honest in grading +- Difficult exams are good - they show real gaps +- Use results to adjust study approach, not to feel bad diff --git a/Tracking/MonthlySitReps/README.md b/Tracking/MonthlySitReps/README.md new file mode 100644 index 0000000..3249c4f --- /dev/null +++ b/Tracking/MonthlySitReps/README.md @@ -0,0 +1,63 @@ +# Monthly Sit Reps + +Comprehensive monthly reports generated on Week 4 Sunday after all exams are completed. + +## Purpose + +The Monthly Situation Report (Sit Rep) serves as: +- **Accountability** to yourself and Tingting +- **Progress tracking** over time +- **Performance analysis** to identify strengths and weaknesses +- **Planning tool** for next month's focus + +## Format + +Two versions generated: +- **Markdown** (`.md`) - Easy to read and edit +- **HTML** (`.html`) - Pretty format for sharing with Tingting + +## Naming Convention + +`YYYY-MM-MonthName-SitRep.md` (e.g., `2025-10-October-SitRep.md`) + +## Template + +See `templates/` folder for: +- `monthly-sitrep-template.md` +- `monthly-sitrep-template.html` (to be created) + +Full template structure in: `docs/Chinese-Learning-System.md` section 9.1 + +## Content Sections + +1. **Chapters Progress** - NEW chapters completed by skill, overall progress +2. **Exam Results** - All 5 exam scores, average, pass/difficulty/critical status +3. **Performance Metrics** - Streak, consistency, time spent, balance +4. **Strengths** - What went well this month +5. **Weaknesses** - What needs improvement +6. **Games Performance** - Games played and scores +7. **Goals for Next Month** - Specific targets and actions +8. **Communication with Tingting** - Summary to share + +## Generation Process + +Week 4 Sunday workflow: +1. Review all daily logs from the month +2. Compile exam results from Saturday +3. Calculate all metrics +4. Identify patterns and trends +5. Write the sit rep (MD) +6. Generate HTML version +7. Share with Tingting + +## Storage + +All sit reps are kept here for historical reference. Over time, you can see: +- Progress trends +- Improving exam scores +- Evolving study patterns +- Achievement of milestones + +## Accountability + +The sit rep is meant to be shared with Tingting. It's honest, objective, and shows both wins and challenges. No hiding from the numbers! diff --git a/Tracking/README.md b/Tracking/README.md new file mode 100644 index 0000000..f1c3d9d --- /dev/null +++ b/Tracking/README.md @@ -0,0 +1,86 @@ +# Tracking - Progress and Accountability + +This folder contains all tracking materials for daily progress, weekly summaries, monthly reports, and exam results. + +## Structure + +``` +Tracking/ +├── DailyLogs/ # Daily study logs +│ └── 2025-10/ # Organized by month +├── WeeklySummaries/ # Auto-generated weekly summaries +├── MonthlySitReps/ # Monthly situation reports +│ └── templates/ # Templates for MD and HTML +└── ExamResults/ # Exam scores and analysis +``` + +## Daily Logs + +**Purpose**: Track every study session +**Format**: Markdown +**Naming**: `YYYY-MM-DD.md` + +Each daily log includes: +- Session info (day, skill focus, time spent, streak) +- Chapter work (chapter ID, type NEW/REVIEW, progress, games completed) +- Additional reviews done +- Notes and observations +- Vocabulary learned + +See templates in: `docs/Chinese-Learning-System.md` section 8.1 + +## Weekly Summaries + +**Purpose**: Review the week's progress +**Generated**: End of each week (automatically) +**Format**: Markdown + +Includes: +- Chapters completed (NEW + REVIEW) +- Total time spent +- Games completed +- SRS reviews completed +- Notes for next week + +## Monthly Sit Reps + +**Purpose**: Comprehensive monthly review and accountability +**Generated**: Week 4 Sunday (after exams) +**Format**: Markdown + HTML + +The sit rep includes: +- Chapters progress (by skill) +- Exam results (all 5 skills + average) +- Performance metrics (streak, consistency, time) +- Balance between skills +- Strengths and weaknesses identified +- Goals for next month +- Communication with Tingting + +Templates in: `MonthlySitReps/templates/` + +## Exam Results + +**Purpose**: Track exam performance over time +**Format**: Markdown + raw scores + +Each exam set (monthly) includes: +- Individual exam scores (/100) for each skill +- Pass/Difficulty/Critical status +- Detailed feedback per exam +- Trends over time + +## Key Metrics + +- **Streak**: Consecutive days of study +- **Consistency**: % of days with practice (target: >80%) +- **Velocity**: Chapters per week (target: 6) +- **Retention**: Exam scores (target: >80%) +- **Balance**: Time distribution across 5 skills + +## Notes + +- Daily logs are mandatory - even 10min counts +- Sit reps are shared with Tingting for accountability +- Exam results inform next month's focus areas +- Be honest in tracking - no free rides! diff --git a/Tracking/WeeklySummaries/README.md b/Tracking/WeeklySummaries/README.md new file mode 100644 index 0000000..bef5829 --- /dev/null +++ b/Tracking/WeeklySummaries/README.md @@ -0,0 +1,55 @@ +# Weekly Summaries + +Auto-generated summaries at the end of each week. + +## Format + +Files named: `Week-YYYY-WXX.md` (e.g., `Week-2025-W44.md`) + +## Content + +Each summary includes: +- Chapters completed this week (NEW + REVIEW) +- Total time spent +- Games completed +- SRS reviews completed +- Notes for next week + +## Generation + +These should be generated automatically by reviewing the daily logs from Monday-Sunday. + +## Purpose + +Weekly summaries help: +- See patterns in study habits +- Adjust next week's plan +- Identify if falling behind on reviews +- Celebrate weekly wins + +## Example + +```markdown +# Week Summary - Week 44, 2025 + +**Period**: October 28 - November 3, 2025 + +## Chapters This Week +- **NEW**: Kouyu Ch3, LEDU Ch5, Tingli Ch8 (3 chapters) +- **REVIEW**: Kouyu Ch1 (L2), Hanyu Ch1 (L3), LEDU Ch3 (L1), Tingli Ch5 (L2) (4 reviews) +- **Total**: 7 chapters + +## Time Investment +- **Total**: 9h 45min +- **Average**: 1h 24min/day +- **Days active**: 6/7 + +## Games & Reviews +- Games completed: 9/9 (100%) +- SRS reviews on schedule: Yes + +## Notes for Next Week +- Kouyu Ch3 needs more speaking practice +- LEDU vocabulary retention good +- Focus on Hanyu grammar patterns next week +``` diff --git a/audio_resources/README.md b/audio_resources/README.md new file mode 100644 index 0000000..9df1127 --- /dev/null +++ b/audio_resources/README.md @@ -0,0 +1,53 @@ +# Audio Resources + +Audio files for listening practice, pronunciation, and shadowing exercises. + +## Current Contents + +- `intermediate_listening_1/` - Audio for Tingli (听力) book chapters + +## Organization + +Audio should be organized by: +1. **Book** (Kouyu, Hanyu, LEDU, Tingli, Xiezuo) +2. **Chapter** within each book +3. **File number** if multiple audio files per chapter + +## Naming Convention + +``` +BookName/ChapterXX/audio-01.mp3 +``` + +Example: +``` +Tingli/Chapter04/audio-01.mp3 +Tingli/Chapter04/audio-02.mp3 +Kouyu/Chapter01/dialogue-01.mp3 +``` + +## Usage + +Audio files are referenced in: +- Markdown content (Content/) - for studying +- JSON files (ClassGenSystem/) - for games and exercises +- Daily practice - for shadowing and listening + +## File Formats + +Preferred: MP3 (widely compatible) +Acceptable: WAV, M4A, OGG + +## Integration + +When digitizing chapters: +1. Save audio files here with clear naming +2. Reference the audio path in the Markdown file +3. Include audio metadata in JSON (file path, duration, transcript availability) + +## Notes + +- Keep audio quality high for clear pronunciation +- If transcripts exist, save them with audio files +- Some chapters may have multiple audio files (dialogues, exercises, etc.) +- Link to external audio sources if copyright prevents local storage diff --git a/docs/Chinese-Learning-System.md b/docs/Chinese-Learning-System.md new file mode 100644 index 0000000..7d82608 --- /dev/null +++ b/docs/Chinese-Learning-System.md @@ -0,0 +1,513 @@ +# Chinese Learning System - Application du ULLF + +**Basé sur** : Universal Language Learning Framework v1.1 + +--- + +## 1. Configuration Langue + +```yaml +language: + name: "Chinois (Mandarin)" + code: "zh-CN" + level: "Intermediate (Zhongyi)" + target: "Parler avec ma femme en chinois" +``` + +--- + +## 2. Les 5 Books Zhongyi + +### 2.1 Inventaire complet + +| Book | Skill | Chapitres | Pages/chap | Total pages | Densité | Status actuel | +|------|-------|-----------|------------|-------------|---------|---------------| +| **LEDU (乐读)** | Reading | 12 | 15 | 180 | Dense | Ch 1-4 en JSON | +| **Kouyu (口语)** | Speaking | 12 | 16 | 192 | Dense | À digitaliser | +| **Hanyu Jiaocheng (汉语教程)** | Composition | 13 | 17 | 221 | Très dense | Ch 1-5 en MD | +| **Tingli (听力)** | Listening | 30 | 4 | 120 | Léger | Ch 4-8 en MD | +| **Xiezuo (写作)** | Writing | 6 | 6 | 36 | Léger | Ch 1-6 en MD | + +**Total : 73 chapters, ~749 pages** + +### 2.2 Répartition par densité + +**Dense (nécessite plus de temps) :** +- Kouyu : 12 ch × 16 pages = 192 pages +- Hanyu : 13 ch × 17 pages = 221 pages +- LEDU : 12 ch × 15 pages = 180 pages + +**Léger (plus rapide) :** +- Tingli : 30 ch × 4 pages = 120 pages +- Xiezuo : 6 ch × 6 pages = 36 pages + +--- + +## 3. Schedule Hebdomadaire + +### 3.1 Assignation fixe par jour + +| Jour | Compétence | Book | Type de contenu | +|------|------------|------|-----------------| +| **Lundi** | Speaking | Kouyu | Dense (16 pages) | +| **Mardi** | Composition | Hanyu Jiaocheng | Très dense (17 pages) | +| **Mercredi** | Reading | LEDU | Dense (15 pages) | +| **Jeudi** | Listening | Tingli | Léger (4 pages) | +| **Vendredi** | Writing | Xiezuo | Léger (6 pages) | +| **Samedi** | Custom/Support | Variable | Review, catch-up, weak points | +| **Dimanche** | FREE | - | Repos, absence, ou rattrapage | + +### 3.2 Rythme NEW vs REVIEW + +**Objectif hebdomadaire (semaines 1-3) :** +- 2-3 nouveaux chapters/semaine +- 3-4 reviews/semaine +- Total : 6 chapters/semaine + +**Pattern suggéré sur 3 semaines :** + +| Semaine | Lun (Kouyu) | Mar (Hanyu) | Mer (LEDU) | Jeu (Tingli) | Ven (Xiezuo) | Sam (Support) | +|---------|-------------|-------------|------------|--------------|--------------|---------------| +| **S1** | NEW | NEW | REVIEW | NEW | REVIEW | REVIEW | +| **S2** | REVIEW | REVIEW | NEW | NEW | REVIEW | REVIEW | +| **S3** | REVIEW | NEW | REVIEW | NEW | REVIEW | REVIEW | + +**Résultat : ~9 NEW / ~9 REVIEW sur 3 semaines** + +--- + +## 4. Cycle Mensuel + +### 4.1 Semaines 1-3 : Learning + Review + +**Chaque jour (1-2h) :** +- 60-70% : Nouveau contenu OU Review SRS principal +- 20-30% : Multiple reviews (L1, L2, L3, L4) +- 10% : 3 jeux par chapter complété + +**Speaking practice :** +- Lundi (Kouyu day) : Focus speaking avec le chapter +- Autres jours : Intégré dans les games quand applicable +- Solution technique pour speaking quotidien : À développer plus tard + +### 4.2 Semaine 4 : EXAM WEEK + +**Structure :** + +| Jour | Exam | Book testé | Durée | +|------|------|------------|-------| +| **Lundi** | Speaking | Kouyu (chapters du mois) | 45min | +| **Mardi** | Composition | Hanyu (chapters du mois) | 60min | +| **Mercredi** | Reading | LEDU (chapters du mois) | 45min | +| **Jeudi** | Listening | Tingli (chapters du mois) | 45min | +| **Vendredi** | Writing | Xiezuo (chapters du mois) | 45min | +| **Samedi** | Correction | Tous les exams | 2-3h | +| **Dimanche** | Sit Rep | Génération rapport mensuel | 1h | + +**Exams coverage :** +- Contenu des 3 dernières semaines (~9 nouveaux chapters) +- Tous les reviews effectués +- Grammar/vocab de tous les chapters touchés + +--- + +## 5. Spaced Repetition System + +### 5.1 Schedule de review par chapter + +Quand tu complètes un chapter (jour 0), il entre dans le cycle : + +| Level | Timing | Durée | Activités | +|-------|--------|-------|-----------| +| **NEW** | Day 0 | 1-2h | Study complet + 3 games | +| **L1** | Day 1 | 10min | Flash vocab + grammar recall | +| **L2** | Day 3 | 20min | Redo exercises + flashcards | +| **L3** | Day 7 | 30min | Production (speak/write with content) | +| **L4** | Day 14 | 30min | Advanced production + integration | +| **L5** | Day 30 | Exam | Testé dans exam mensuel | +| **MASTERED** | After exam >80% | - | Chapter maîtrisé | + +### 5.2 Tracking SRS + +Chaque chapter a un status dans le système : +``` +NEW → L1 → L2 → L3 → L4 → L5 (exam) → MASTERED +``` + +Le samedi (jour Support) est idéal pour faire les reviews L3/L4 qui prennent plus de temps. + +--- + +## 6. Game System (3 per chapter) + +### 6.1 Structure des jeux + +**Game 1 : Vocabulary Challenge** +- Matching game chinois-français +- Flashcards interactives avec pinyin +- Quiz rapide de reconnaissance +- **Data** : vocab du chapter avec pronunciation, meaning, examples + +**Game 2 : Grammar Pattern Practice** +- Sentence building puzzles +- Transformation exercises (ex: transformer en 把 sentence) +- Fill-in-the-blank avec structures +- **Data** : grammar patterns du chapter avec exemples + +**Game 3 : Production Game** +- Speaking prompts avec vocab imposé +- Writing challenges avec contraintes +- Listening comprehension puzzles +- Role-play scenarios +- **Data** : contextes réels utilisant le contenu du chapter + +### 6.2 Integration classGen + +Format JSON pour chaque game : +```json +{ + "chapter_id": "ledu-chapter1", + "games": [ + { + "id": "game1-vocab", + "type": "vocabulary-matching", + "title": "食为天 - Vocabulary Challenge", + "description": "Match Chinese food vocabulary with meanings", + "data": { + "pairs": [ + {"chinese": "重视", "pinyin": "zhòngshì", "meaning": "to attach importance to"}, + // ... more pairs + ] + }, + "completion_criteria": {"min_score": 80} + }, + { + "id": "game2-grammar", + "type": "sentence-builder", + "title": "因此 Pattern Practice", + "data": { + "pattern": "...，因此...", + "examples": [...], + "exercises": [...] + } + }, + { + "id": "game3-production", + "type": "speaking-challenge", + "title": "Restaurant Conversation", + "data": { + "scenario": "Order food at a Chinese restaurant", + "required_vocab": ["味道", "麻辣", "火锅", "口味"], + "prompts": [...] + } + } + ] +} +``` + +--- + +## 7. Exam System + +### 7.1 Passing Criteria (Rappel) + +- **>80%** : PASS ✓ - Excellent, continue +- **50-80%** : DIFFICULTY ⚠ - Révision nécessaire, identifie les weak points +- **<50%** : CRITICAL ✗ - Arrête la progression, révision intensive + +### 7.2 Exams par compétence + +**Lundi - Speaking Exam (Kouyu)** +- Monologue 3-5min sur topics du mois +- Q&A spontané (5 questions) +- Production libre avec vocab imposé +- **Score** : /100 (fluency + vocab usage + grammar + pronunciation) + +**Mardi - Composition Exam (Hanyu)** +- Grammar patterns (10 phrases à compléter) +- Transformation sentences (6 phrases) +- Production originale (5 phrases) +- **Score** : /100 (grammar accuracy + creativity) + +**Mercredi - Reading Exam (LEDU)** +- Vocabulary test (15 mots) +- Nouveau texte + 10 questions +- Character inference (5 caractères) +- **Score** : /100 (vocab + comprehension + inference) + +**Jeudi - Listening Exam (Tingli)** +- 2 audios nouveaux + questions +- 1 audio des chapters + questions détaillées +- Dictée (5 phrases) +- **Score** : /100 (global + detailed + dictation) + +**Vendredi - Writing Exam (Xiezuo)** +- Écriture guidée 150-200 caractères (10 vocab imposés) +- Écriture libre 150-200 caractères +- Correction d'erreurs (10 phrases) +- **Score** : /100 (guided + free + correction) + +*Frameworks détaillés dans document séparé : Exam-Frameworks.md* + +--- + +## 8. Daily Tracking + +### 8.1 Daily Log Format + +```markdown +# Daily Log - [YYYY-MM-DD] + +## Session Info +- **Day of Week**: [Lundi-Dimanche] +- **Skill Focus**: [Speaking|Composition|Reading|Listening|Writing|Support] +- **Time Spent**: Xh Ymin +- **Streak**: X days + +## Chapter Work +- **Chapter**: [book-name] Chapter X +- **Type**: [NEW|REVIEW-L1|REVIEW-L2|REVIEW-L3|REVIEW-L4] +- **Progress**: X% +- **Games Completed**: X/3 + +## Additional Reviews +- Chapter Y (L1) - 10min +- Chapter Z (L2) - 20min + +## Notes & Observations +- **What went well**: ... +- **Difficulties encountered**: ... +- **Tomorrow's focus**: ... + +## Vocabulary Learned +- 词语 (cíyǔ) - word, vocabulary +- [other new vocab] +``` + +### 8.2 Weekly Summary (auto-generated) + +À la fin de chaque semaine, generate un summary : +- Chapters completed this week (NEW + REVIEW) +- Total time spent +- Games completed +- SRS reviews completed +- Notes for next week + +--- + +## 9. Monthly Sit Rep + +### 9.1 Structure (.md + .html) + +```markdown +# CHINESE LEARNING - Monthly Sit Rep +**Month**: [Month YYYY] +**Generated**: [Date] + +--- + +## 📊 Chapters Progress + +### New Chapters Completed This Month +- **Kouyu (Speaking)**: Chapters X, Y (Total: Z/12) +- **Hanyu (Composition)**: Chapters X, Y (Total: Z/13) +- **LEDU (Reading)**: Chapters X, Y (Total: Z/12) +- **Tingli (Listening)**: Chapters X, Y, Z (Total: W/30) +- **Xiezuo (Writing)**: Chapter X (Total: Z/6) + +**Total NEW**: X chapters (Target: 9) +**Total REVIEW**: Y chapters (Target: 9) + +### Overall Progress +- **Total Chapters Completed**: X/73 (Y%) +- **Estimated Time Remaining**: Z months at current pace + +--- + +## 🎯 Exam Results (Week 4) + +| Skill | Score | Status | Notes | +|-------|-------|--------|-------| +| Speaking (Kouyu) | X/100 | [PASS/DIFFICULTY/CRITICAL] | ... | +| Composition (Hanyu) | X/100 | [PASS/DIFFICULTY/CRITICAL] | ... | +| Reading (LEDU) | X/100 | [PASS/DIFFICULTY/CRITICAL] | ... | +| Listening (Tingli) | X/100 | [PASS/DIFFICULTY/CRITICAL] | ... | +| Writing (Xiezuo) | X/100 | [PASS/DIFFICULTY/CRITICAL] | ... | + +**Average Score**: X/100 + +### Exam Analysis +- **Passed (>80%)**: X exams +- **Difficulty (50-80%)**: X exams +- **Critical (<50%)**: X exams + +--- + +## 📈 Performance Metrics + +- **Streak**: X days (Longest: Y days) +- **Consistency**: X% (Z/30 days with practice) +- **Average Daily Time**: Xh Ymin +- **Games Completed**: X/Y (Z%) + +### Balance Between Skills +- Speaking: X% of time +- Composition: X% of time +- Reading: X% of time +- Listening: X% of time +- Writing: X% of time + +--- + +## 💪 Strengths This Month + +1. [Compétence qui s'améliore le plus] +2. [Vocab/grammar bien maîtrisé] +3. [Habitudes positives établies] + +**Example vocabulary mastered**: [liste de mots clés] +**Grammar patterns mastered**: [liste de structures] + +--- + +## ⚠️ Weaknesses Identified + +1. [Compétence nécessitant plus de travail] +2. [Erreurs récurrentes] +3. [Obstacles rencontrés] + +**Specific difficulties**: [détails] +**Missed days**: [raisons si applicable] + +--- + +## 🎮 Games Performance + +- **Total Games Played**: X +- **Average Score**: Y% +- **Favorite Game Type**: [vocabulary|grammar|production] + +--- + +## 🎯 Goals for Next Month + +### Primary Focus +- [Skill prioritaire basé sur exam results] +- [Specific improvement goal] + +### Targets +- ✓ Study X new chapters +- ✓ Maintain >80% consistency +- ✓ Improve [weak skill] by X% +- ✓ Complete all 3 games per chapter + +### Specific Actions +1. [Action concrète pour améliorer point faible] +2. [Nouvelle stratégie à tester] +3. [Resource additionnelle à utiliser] + +--- + +## 💬 Communication with Tingting + +**Progress to share**: [résumé pour Tingting] +**Challenges to discuss**: [points à discuter] +**Wins to celebrate**: [succès du mois] + +--- + +*Generated by Chinese Learning System v1.0* +*Next Sit Rep: [Date]* +``` + +### 9.2 HTML Version + +Le HTML version aura : +- Graphiques de progression (bar charts) +- Color coding (vert >80%, orange 50-80%, rouge <50%) +- Interactive timeline de streak +- Visual balance wheel pour les 5 compétences +- Prettier formatting pour sharing + +--- + +## 10. Timeline Estimée + +### 10.1 Calculs + +**Rythme actuel** : ~9 nouveaux chapters/mois + +**Par book** : +- Kouyu (12 ch) : ~1.3 mois +- Hanyu (13 ch) : ~1.4 mois +- LEDU (12 ch) : ~1.3 mois +- Tingli (30 ch) : ~3.3 mois +- Xiezuo (6 ch) : ~0.7 mois + +**Total** : 73 chapters ÷ 9 per month = **~8-9 mois** pour tout couvrir + +*Avec reviews, exams, et flexibilité : ~10-12 mois réaliste* + +### 10.2 Milestones + +- **Mois 3** : ~25 chapters (33%) +- **Mois 6** : ~50 chapters (68%) +- **Mois 9** : ~73 chapters (100%) +- **Mois 12** : Full mastery avec reviews + +--- + +## 11. Success Criteria + +### 11.1 Monthly (Court terme) +- ✓ >80% consistency (24/30 days minimum) +- ✓ 5 compétences touchées chaque semaine +- ✓ Exam average >80% +- ✓ Streak >20 days +- ✓ 3 games per chapter completed + +### 11.2 6-Month (Moyen terme) +- ✓ 50+ chapters completed +- ✓ Exam average maintained >80% +- ✓ Speaking confidence notable +- ✓ Can have basic conversations with wife in Chinese +- ✓ No CRITICAL exams (<50%) + +### 11.3 12-Month (Long terme) +- ✓ All 73 chapters completed +- ✓ Exam average >85% +- ✓ Fluent conversations with wife +- ✓ Can read/write/listen without major difficulty +- ✓ All chapters at MASTERED status + +--- + +## 12. Next Steps + +### 12.1 Setup Immédiat +1. ✓ Framework défini +2. ⏳ Créer les Exam Frameworks détaillés +3. ⏳ Setup le daily log template +4. ⏳ Setup le sit rep templates (.md + .html) +5. ⏳ Digitaliser les chapters manquants (Kouyu surtout) +6. ⏳ Générer les 3 games pour chapters existants + +### 12.2 Première Semaine +1. Choisir le starting point (quels chapters commencer) +2. Faire Day 1 (Lundi) avec Kouyu Chapter X +3. Logger dans daily log +4. Compléter les 3 games +5. Speaking practice quotidienne +6. Continuer le pattern + +### 12.3 Premier Mois +- Semaines 1-3 : Pattern NEW/REVIEW +- Semaine 4 : Premier exam + premier sit rep +- Ajuster selon résultats +- Share avec Tingting + +--- + +## Version + +- v1.0 (2025-10-29) : Chinese-specific application of ULLF v1.1 diff --git a/docs/Learning-Plan-Chinese.md b/docs/Learning-Plan-Chinese.md new file mode 100644 index 0000000..7418283 --- /dev/null +++ b/docs/Learning-Plan-Chinese.md @@ -0,0 +1,144 @@ +# 我的中文学习计划 + +## 目标 + +学好中文，能够和我老婆自然地交流。我不想再为了表达自己而挣扎——我想自然地说中文，也能听懂她说的话。 + +--- + +## 我的学习材料 + +我有中级汉语课程的5本教材： +- **口语书**（Kouyu）- 12课，比较厚 +- **作文书**（Hanyu）- 13课，最厚的一本 +- **阅读书**（LEDU/乐读）- 12课，词汇量很大 +- **听力书**（Tingli）- 30课，但每课比较短 +- **写作书**（Xiezuo）- 6课，比较快 + +总共73课。如果我保持好的学习节奏，大约10个月可以全部学完。 + +--- + +## 我的每周安排 + +为了简单，每周都一样，不用每天想"今天学什么"： + +**星期一**：口语练习（Kouyu） +**星期二**：作文（Hanyu） +**星期三**：阅读（LEDU） +**星期四**：听力（Tingli） +**星期五**：写作（Xiezuo） +**星期六**：补习日 - 复习薄弱环节或补上缺的课 +**星期日**：自由日 - 生活中总会有事，这是我的缓冲时间 + +每天学习1-2小时。 + +--- + +## 每月怎么安排 + +### 第1-3周：学习和复习 + +我会交替学习新课和复习旧课。有些天学新内容，有些天回去巩固学过的东西。 + +大致的安排： +- 每周2-3课新内容 +- 每周3-4次复习 +- 每周学习6天（星期日休息） + +学完一课后，它不会就这样消失。它会按计划回来复习： +- 第二天：快速复习词汇（10分钟） +- 3天后：重做一些练习（20分钟） +- 1周后：用这课的内容练习口语/写作（30分钟） +- 2周后：更高级的练习 +- 1个月后：出现在月度考试中 + +这种间隔重复的方法能让我记得更牢。 + +### 第4周：考试周 + +与其整个月一直学新内容，我用第四周来测试自己。每天一个考试： + +**星期一**：口语考试 +**星期二**：作文考试 +**星期三**：阅读考试 +**星期四**：听力考试 +**星期五**：写作考试 +**星期六**：批改所有考试，看看自己的水平 +**星期日**：写月度报告 + +考试是认真的，没有捷径。我需要考80分以上才算真正通过。50-80分之间说明我在这个技能上有困难，需要多关注。50分以下是红色警报，说明我需要在继续之前认真复习。 + +--- + +## 为什么这个方法适合我 + +**不用每天做决定**：星期一永远是口语日。我不会每天早上醒来想"今天该学什么？" + +**实际的灵活性**：生活不完美。所以星期六是补习日，星期日完全自由。如果我在工作日错过了一天，可以在星期六补上。如果这周很忙，星期日还可以当备用。 + +**责任感**：每个月都以考试和报告结束。我无法逃避数字。我会和老婆分享这些报告，让她看到我的进步（也让她监督我）。 + +**平衡发展**：我不只做容易的部分。每个技能都有它的日子，包括我不擅长的。 + +--- + +## 游戏 + +从教材学习可能很无聊，所以我为每一课制作3个小游戏： + +1. **词汇游戏**：配对中文单词和意思，快速测验，闪卡 +2. **语法游戏**：造句，转换句型，填空 +3. **产出游戏**：真实场景，我必须用学到的内容说话或写作 + +这些让复习变得更有趣，不只是重新看笔记。 + +--- + +## 跟踪进度 + +我每天记录简单的日志： +- 学了哪一课 +- 花了多少时间 +- 哪些地方做得好，哪些很难 +- 目前连续学习的天数 + +每个月末，我生成一份报告，显示： +- 完成了多少课 +- 我的考试分数 +- 我的一致性（实际上大多数日子都学了吗？） +- 我擅长什么，什么需要改进 +- 下个月的目标 + +这份报告会和老婆分享。这是我保持责任感的方式。 + +--- + +## 时间表 + +按照我目前的速度（每月约9课新内容），我大概8-9个月能学完所有73课。加上复习时间和考试周，总共大约一年。 + +**3个月时**：完成大约三分之一 +**6个月时**：超过一半，应该明显更自信了 +**9个月时**：所有课程完成 +**12个月时**：全部掌握，能流利地和老婆说中文 + +--- + +## 本周开始 + +计划已经准备好了。现在我只需要： + +1. 选择从哪些课开始 +2. 完成第一个星期一（口语日） +3. 在日志里记录 +4. 保持连续学习 +5. 每天出现，哪怕只有30分钟 + +系统很简单。安排很清楚。不要想太多——只要坚持工作，一天一天来，直到我能和老婆自然地说中文。 + +这就是计划。 + +--- + +**注意**：这个计划可能会随着时间调整，但至少这是我目前的工作框架。 diff --git a/docs/Learning-Plan-Simple.md b/docs/Learning-Plan-Simple.md new file mode 100644 index 0000000..7735159 --- /dev/null +++ b/docs/Learning-Plan-Simple.md @@ -0,0 +1,145 @@ +# My Chinese Learning Plan + +## The Goal + +Learn Chinese well enough to have real conversations with my wife. No more struggling to express myself - I want to speak naturally and understand her when she talks to me. + +--- + +## What I'm Working With + +I have 5 textbooks from my intermediate Chinese course: +- **Speaking book** (Kouyu) - 12 chapters, pretty thick +- **Composition book** (Hanyu) - 13 chapters, the longest one +- **Reading book** (LEDU) - 12 chapters, lots of vocabulary +- **Listening book** (Tingli) - 30 chapters, but they're short +- **Writing book** (Xiezuo) - 6 chapters, pretty quick + +That's 73 chapters total. If I keep a good pace, I can finish everything in about 10 months. + +--- + +## My Weekly Routine + +I'm keeping it simple - same thing every week so I don't have to think about it: + +**Monday**: Speaking practice (Kouyu) +**Tuesday**: Composition work (Hanyu) +**Wednesday**: Reading (LEDU) +**Thursday**: Listening (Tingli) +**Friday**: Writing (Xiezuo) +**Saturday**: Catch-up day - review weak spots or make up missed work +**Sunday**: Free day - life happens, so this is my buffer + +Each day takes 1-2 hours. The most important part? I practice speaking EVERY day, even if it's just 15-20 minutes of talking to myself or shadowing audio. Speaking is my weakest skill, so it needs daily attention. + +--- + +## How the Month Works + +### Weeks 1-3: Learning and Reviewing + +I alternate between learning new chapters and reviewing old ones. Some days I tackle fresh material, other days I go back and reinforce what I learned before. + +The pattern roughly works out to: +- 2-3 new chapters per week +- 3-4 review sessions per week +- 6 days of study (with Sunday free) + +When I finish a chapter, it doesn't just disappear. It comes back for review: +- Next day: Quick vocab check (10 minutes) +- 3 days later: Redo some exercises (20 minutes) +- 1 week later: Practice speaking/writing with that content (30 minutes) +- 2 weeks later: More advanced practice +- 1 month later: It shows up on the monthly exam + +This spaced repetition keeps things fresh in my memory. + +### Week 4: Exam Week + +Instead of grinding through new material all month, I take the fourth week to test myself properly. One exam per day: + +**Monday**: Speaking exam +**Tuesday**: Composition exam +**Wednesday**: Reading exam +**Thursday**: Listening exam +**Friday**: Writing exam +**Saturday**: Grade everything and see where I stand +**Sunday**: Write up a monthly report + +The exams are real - no shortcuts. I need to score above 80% to truly pass. Between 50-80% means I'm struggling with that skill and need to focus on it more. Below 50% is a red flag that I need to seriously review before moving forward. + +--- + +## Why This Works for Me + +**No decision fatigue**: Monday is always speaking day. I never wake up wondering "what should I study today?" + +**Realistic flexibility**: Life isn't perfect. That's why Saturday is catch-up day and Sunday is completely free. If I miss a day during the week, I can make it up on Saturday. If I have a rough week, Sunday is there as backup. + +**Accountability**: Every month ends with exams and a report. I can't hide from the numbers. I'll share these reports with my wife so she can see my progress (and keep me honest). + +**Balanced development**: I'm not just doing the fun stuff. Every skill gets its day, including the ones I'm bad at. + +--- + +## The Games + +Learning from a textbook can be boring, so I'm building 3 mini-games for every chapter: + +1. **Vocabulary game**: Matching Chinese words to meanings, quick quizzes, flashcards +2. **Grammar game**: Building sentences, transforming patterns, filling in blanks +3. **Production game**: Real scenarios where I have to speak or write using what I learned + +These make the review sessions way more engaging than just re-reading notes. + +--- + +## Tracking Progress + +I keep a simple daily log: +- What chapter I worked on +- How much time I spent +- Whether I did my speaking practice +- What went well and what was hard +- Current streak of consecutive days + +At the end of each month, I generate a report showing: +- How many chapters I completed +- My exam scores +- My consistency (did I actually study most days?) +- What I'm good at and what needs work +- Goals for next month + +This report gets shared with my wife. It's my way of staying accountable. + +--- + +## The Timeline + +At my current pace (about 9 new chapters per month), I'll finish all 73 chapters in roughly 8-9 months. Add in the review time and exam weeks, and I'm looking at about a year total. + +**3 months in**: About a third of the way through +**6 months in**: Over halfway, should be noticeably more confident +**9 months in**: All chapters completed +**12 months in**: Everything mastered, speaking fluently with my wife + +--- + +## Starting This Week + +The plan is ready. Now I just need to: + +1. Pick which chapters to start with +2. Do my first Monday (speaking day) +3. Log it in my daily tracker +4. Keep the streak going +5. Show up every day, even if it's just for 30 minutes + +The system is simple. The routine is clear. No more overthinking - just consistent work, one day at a time, until I can speak Chinese naturally with my wife. + +That's the plan. + +--- + +**Note**: The plan might change with time but that's my working framework at least. diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 0000000..321d8cd --- /dev/null +++ b/docs/README.md @@ -0,0 +1,46 @@ +# Documentation + +This folder contains all planning documents and frameworks for the Chinese learning system. + +## Files + +### Learning Plans +- **[Learning-Plan-Simple.md](Learning-Plan-Simple.md)** - Simple, human-readable plan in English +- **[Learning-Plan-Chinese.md](Learning-Plan-Chinese.md)** - Chinese version (学习计划) for Tingting + +### Technical Documentation +- **[Chinese-Learning-System.md](Chinese-Learning-System.md)** - Complete technical implementation for Chinese + - The 5 books breakdown + - Weekly schedule and NEW/REVIEW patterns + - SRS system details + - Game structure + - Exam system + - Tracking templates + - Monthly sit rep structure + +### Frameworks +- **[Universal-Language-Learning-Framework.md](Universal-Language-Learning-Framework.md)** - Universal framework (ULLF v1.1) + - Works for any language + - Core principles and methodology + - Adaptable structure + +### To Be Created +- **Exam-Frameworks.md** - Detailed exam structures for each skill (Speaking, Listening, Reading, Writing, Composition) + +## Purpose + +These documents serve as: +- **Reference** for the learning methodology +- **Planning** for daily/weekly/monthly activities +- **Communication** with Tingting about progress +- **Accountability** framework + +## Updates + +Documentation should be updated when: +- The learning method changes significantly +- New insights emerge from actual practice +- Exam formats need adjustment +- Timeline or goals shift + +Remember: *The plan might change with time but that's the working framework.* diff --git a/docs/Universal-Language-Learning-Framework.md b/docs/Universal-Language-Learning-Framework.md new file mode 100644 index 0000000..216e55f --- /dev/null +++ b/docs/Universal-Language-Learning-Framework.md @@ -0,0 +1,384 @@ +# Universal Language Learning Framework (ULLF) + +## 1. Core Principles + +### 1.1 Les 5+1 Compétences Fondamentales +- **Reading (Lecture)** - Input passif écrit +- **Listening (Écoute)** - Input passif oral +- **Writing (Écriture)** - Output actif écrit +- **Speaking (Expression orale)** - Output actif oral +- **Composition** - Output structuré et académique +- **+1 Custom/Support** - Jour flexible pour combler manques ou absences + +**Note** : Grammar/Structure est intégré dans chaque chapitre, pas de différenciation séparée + +### 1.2 Hiérarchie d'apprentissage +``` +Input (Reading + Listening) → Comprehension → Output (Speaking + Writing + Composition) + ↓ + Grammar (intégré dans chapters) + ↓ + Active Usage + ↓ + Games (3 per chapter) +``` + +### 1.3 Principes clés +- **Consistency over Intensity** - Daily practice > marathon sessions +- **Balanced Development** - Les 5 compétences progressent ensemble +- **Accountability** - Tracking + Exams réguliers +- **Spaced Repetition** - Review systématique pour retention +- **No Free Ride** - Tracking strict, pas de skip invisible +- **Game-Based Learning** - 3 jeux par chapitre pour rendre l'apprentissage interactif +- **Flexibility** - 1 jour/semaine libre pour combler les manques + +--- + +## 2. Structure Temporelle + +### 2.1 Cycle mensuel (4 semaines) +- **Semaines 1-3** : Learning + Review +- **Semaine 4** : Exam + Sit Rep + Planning + +### 2.2 Rythme hebdomadaire +- **NEW content** : 2-3 chapters/semaine +- **REVIEW content** : 3-4 chapters/semaine +- **Total** : 6 chapters/semaine (1 par jour) +- **Jour 7** : FREE - Pour combler manques, absences, ou renforcer points faibles + +### 2.3 Structure journalière (1-2h) +- **60-70%** : Nouveau contenu OU Review SRS principal +- **20-30%** : Reviews espacées multiples +- **10%** : Games (3 per chapter) + +### 2.4 Assignation des jours +**Principe** : Chaque jour = 1 compétence fixe (6 jours/semaine) +- **Jour 1** : Speaking +- **Jour 2** : Composition +- **Jour 3** : Reading +- **Jour 4** : Listening +- **Jour 5** : Writing +- **Jour 6** : Custom/Support (review, catch-up, weak points) +- **Jour 7** : FREE (absence, manque, repos) + +**Avantages** : +- Routine prévisible +- Mental load réduit +- Pas de decision fatigue +- Flexibilité intégrée pour la vie réelle + +--- + +## 3. Content Structure + +### 3.1 Types de ressources par compétence + +**Reading :** +- Textes gradués par difficulté +- Vocab in context +- Comprehension questions +- Speed reading practice + +**Listening :** +- Audio gradué par vitesse/accent +- Transcriptions disponibles +- Comprehension questions +- Shadowing material + +**Writing :** +- Guided writing (structures imposées) +- Free writing (topics ouverts) +- Error correction exercises +- Style practice + +**Speaking :** +- Dialogues/Scripts +- Pronunciation drills +- Topics discussion +- Recording/self-assessment + +**Composition :** +- Structured academic writing +- Essay/text production +- Formal language practice +- Synthesis of multiple skills + +**Grammar :** +- Intégré dans chaque chapter (pas de section séparée) +- Patterns/Structures enseignés en contexte +- Exercises de transformation dans chaque skill + +### 3.2 Game Integration +**Chaque chapter inclut 3 jeux** pour renforcer l'apprentissage de manière interactive : + +**Game 1 : Vocabulary Challenge** +- Matching game, flashcards interactives, ou quiz rapide +- Focus sur mémorisation du vocab du chapter + +**Game 2 : Grammar/Pattern Practice** +- Sentence building, transformation puzzles +- Application des structures grammaticales + +**Game 3 : Production Game** +- Role-play scenarios, writing challenges, listening puzzles +- Utilisation active du contenu dans un contexte ludique + +**Integration dans classGen** : Les jeux sont générés en JSON et jouables via l'interface + +### 3.3 Metadata des resources +Chaque chapter doit avoir : +```json +{ + "id": "unique-id", + "skill": "reading|listening|writing|speaking|composition", + "level": "beginner|intermediate|advanced", + "estimated_hours": 1-3, + "page_count": X, + "density": "light|medium|dense", + "vocabulary_count": X, + "grammar_points": X, + "games": [ + {"type": "vocabulary", "title": "...", "data": {}}, + {"type": "grammar", "title": "...", "data": {}}, + {"type": "production", "title": "...", "data": {}} + ], + "prerequisites": ["chapter-ids"], + "learning_objectives": [] +} +``` + +--- + +## 4. Spaced Repetition System (SRS) + +### 4.1 Review Intervals +Quand un chapter est complété (Day 0), il entre dans le cycle : + +- **Level 1** : Day 1 (review rapide - 10min) +- **Level 2** : Day 3 (review moyen - 20min) +- **Level 3** : Day 7 (review approfondi - 30min) +- **Level 4** : Day 14 (production active - 30min) +- **Level 5** : Day 30 (exam month - inclus dans exam) + +### 4.2 Review Activities par Level + +**Level 1** (Day 1) : +- Flash vocab +- Quick grammar recall +- Re-read/re-listen summary + +**Level 2** (Day 3) : +- Redo quelques exercises +- Active recall (flashcards) +- Mini-production + +**Level 3** (Day 7) : +- Production avec le contenu +- Speak/Write using material +- Identify weak points + +**Level 4** (Day 14) : +- Integration avec nouveau contenu +- Compare/contrast concepts +- Advanced production + +**Level 5** (Day 30) : +- Testé dans l'exam mensuel + +### 4.3 SRS Tracking +Chaque chapter a un status : +``` +NEW → L1 → L2 → L3 → L4 → L5 → MASTERED +``` + +--- + +## 5. Exam System + +### 5.1 Principes +- **Frequency** : Monthly (semaine 4) +- **Coverage** : Tout le contenu des 3 dernières semaines +- **Format** : 1 exam par compétence (5 exams total) +- **Scoring** : /100 par exam +- **Purpose** : Accountability + Identify weak points +- **Generation** : 100% custom basé sur frameworks spécifiques (définis séparément) + +### 5.2 Passing Criteria +- **>80%** : PASS - Maîtrise solide +- **50-80%** : DIFFICULTY - Révision nécessaire, points faibles identifiés +- **<50%** : CRITICAL - Révision intensive requise avant de continuer + +### 5.3 Exam Framework Universel + +Chaque exam suit cette structure générale : + +**Part 1 : Recognition/Comprehension (30-40%)** +- Tester la compréhension passive +- Vocab, grammar, meaning + +**Part 2 : Application (30-40%)** +- Utiliser le contenu dans exercises +- Transformation, fill-in-blank, etc. + +**Part 3 : Production (20-30%)** +- Créer du contenu original +- Speaking/Writing libre avec contraintes + +**Note** : Les frameworks détaillés par compétence (Speaking, Listening, Reading, Writing, Composition) seront définis dans un document séparé + +### 5.4 Scoring Rubric Template +``` +Grammar/Accuracy: /X +Vocabulary Usage: /X +Fluency/Coherence: /X +Comprehension: /X +Creativity/Natural Usage: /X +Total: /100 +``` + +--- + +## 6. Tracking & Accountability + +### 6.1 Daily Log +``` +Date: YYYY-MM-DD +Day of Week: [Lundi-Dimanche] +Skill Focus: [Reading|Listening|Writing|Speaking|Grammar] +Chapter: [book-name] Chapter X +Type: [NEW|REVIEW-L1|REVIEW-L2|etc] +Time Spent: Xh Ymin +Speaking Practice: [Yes/No] - Xmin +Notes: [observations, difficulties, wins] +Streak: X days +``` + +### 6.2 Monthly Sit Rep +Généré automatiquement semaine 4 : + +**Structure** : +- Chapters completed (by skill) +- Exam results (by skill + average) +- Progression metrics (streak, consistency) +- Strong points identified +- Weak points identified +- Next month plan + +**Format** : .md + .html + +### 6.3 Progress Metrics +- **Streak** : Jours consécutifs +- **Consistency** : % de jours avec practice +- **Balance** : Répartition entre les 5 compétences +- **Velocity** : Chapters/semaine +- **Retention** : Exam scores trend +- **Games Completed** : Nombre de jeux complétés par chapter + +--- + +## 7. Adaptation par Langue + +### 7.1 Variables à définir +Pour adapter ce framework à une langue spécifique : + +```yaml +language: + name: "Language Name" + code: "xx-XX" + +books: + - id: "book-1" + name: "Book Name" + skill: "reading|listening|writing|speaking|composition" + chapters: X + pages_per_chapter: Y + density: "light|medium|dense" + +daily_schedule: + day1: "speaking" + day2: "composition" + day3: "reading" + day4: "listening" + day5: "writing" + day6: "custom-support" + day7: "free" + +rhythm: + new_per_week: 2-3 + review_per_week: 3-4 + total_per_week: 6 + exam_week: 4 + +daily_time: + total: "1-2h" + new_content: "40-50%" + speaking: "30-40%" + reviews: "10-20%" + +games_per_chapter: 3 +``` + +### 7.2 Content Integration +Le système doit supporter : +- Import de content depuis books physiques +- Conversion en format digital (MD/JSON) +- Metadata extraction +- Game generation (3 per chapter) +- Exam generation (custom frameworks) + +--- + +## 8. Tools & Ecosystem + +### 8.1 Required Components +- **Content Storage** : Markdown files + JSON +- **Game Engine** : classGen ou similar +- **Tracking System** : Daily logs + metrics +- **Exam Generator** : Custom generation basée sur frameworks +- **Sit Rep Generator** : Automated reporting (.md + .html) + +### 8.2 Workflow +``` +Physical Book → Digitize (MD) → Structure (JSON) → Generate Games → +→ classGen Input → Study + Play Games → Track → +→ SRS Review → Monthly Exam → Sit Rep → Repeat +``` + +--- + +## 9. Success Criteria + +### 9.1 Short-term (1 month) +- ✓ Consistency : >80% jours avec practice (min 24/30 jours) +- ✓ Balance : Les 5 compétences touchées +- ✓ Exam average : >80% (pass rate) +- ✓ Streak : >20 jours +- ✓ Games completed : 3 per chapter studied + +### 9.2 Medium-term (6 months) +- ✓ All books 50% completed +- ✓ Exam average : >80% maintained +- ✓ Speaking confidence notable +- ✓ Can use language in target context +- ✓ No exams in CRITICAL range (<50%) + +### 9.3 Long-term (12 months) +- ✓ All books 100% completed +- ✓ Exam average : >85% +- ✓ Fluent conversation in target language +- ✓ Can read/write/listen without major difficulty +- ✓ All chapters at MASTERED status in SRS + +--- + +## Version History + +- v1.0 (2025-10-29) : Initial framework creation +- v1.1 (2025-10-29) : Corrections post-feedback + - Changed 4+1 to 5+1 skills (added Composition, Custom/Support day) + - Grammar integrated into chapters (not separate) + - 6 days/week + 1 FREE day + - Added 3 games per chapter requirement + - Exam passing criteria: >80% pass, 50-80% difficulty, <50% critical + - Removed XP/Achievement gamification + - Exam generation 100% custom based on frameworks diff --git a/tools/README.md b/tools/README.md new file mode 100644 index 0000000..c0eb326 --- /dev/null +++ b/tools/README.md @@ -0,0 +1,57 @@ +# Tools + +Scripts, utilities, and automation tools for the Chinese learning system. + +## Purpose + +This folder contains: +- Conversion scripts (MD → JSON) +- Game generators +- Exam generators +- Sit rep generators +- Audio processors +- Any automation tools + +## Planned Tools + +### Content Processing +- `md-to-json.js` - Convert Markdown chapters to JSON format +- `generate-games.js` - Auto-generate 3 games per chapter +- `validate-json.js` - Check JSON structure compliance + +### Tracking & Reporting +- `generate-weekly-summary.js` - Create weekly summaries from daily logs +- `generate-sitrep.js` - Create monthly sit rep (MD + HTML) +- `calculate-metrics.js` - Compute streak, consistency, velocity, etc. + +### Exam System +- `generate-exam.js` - Create exams based on month's content +- `grade-exam.js` - Helper for grading exams +- `exam-analysis.js` - Analyze exam results and trends + +### Utilities +- `audio-organizer.js` - Organize and rename audio files +- `chapter-tracker.js` - Track SRS review schedule +- `backup.js` - Backup tracking data + +## Usage + +Each tool should have: +- Clear documentation +- Usage examples +- Error handling +- Command-line interface + +## Development + +Tools can be written in: +- JavaScript/Node.js (preferred for classGen integration) +- Python (for data processing) +- Bash (for simple automation) + +## Notes + +- Keep tools modular and focused +- Document dependencies clearly +- Include tests for critical tools +- Version control tool updates