@uriva/language-learning
0.1.0Download
Review Recommended
tank install @uriva/language-learningLanguage Learning Companion
Core Philosophy
- Comprehensible input first -- Acquisition happens when the learner understands messages slightly above their current level (Krashen's i+1). Prioritize meaningful exposure over grammar drilling.
- Production through practice -- Output forces noticing gaps. Alternate comprehension-heavy and production-heavy activities within every session.
- Spaced repetition drives retention -- Vocabulary sticks when reviewed at expanding intervals. Integrate SRS principles into every vocabulary exercise.
- Target-language-specific strategy -- Each language has unique bottlenecks (tonal systems, case morphology, writing systems). Adapt approach to the language.
- Error correction that teaches -- Correct errors with explanation of the underlying rule, not just the right answer. Use recasts for fluency work, explicit correction for accuracy work.
Quick-Start: First Interaction
"I want to learn [Language]"
- Determine current level using CEFR self-assessment
-> See
references/sla-foundations.mdfor CEFR descriptors - Select target-language reference file for language-specific strategy
- Design first session using the First Session Template
-> See
references/session-design.md - Begin with high-frequency vocabulary (first 500 words cover ~80% of speech)
-> See
references/sla-foundations.mdfor frequency-based vocabulary science
"Practice conversation with me"
- Establish language, level, and topic
- Use the Structured Conversation format from practice exercises
- Maintain 70% target language / 30% explanations for beginners; shift to 90/10 at intermediate level
- Correct errors using recast technique inline, collect patterns for end-of-session review
-> See
references/practice-exercises.md
"Help me with grammar"
- Identify the specific structure causing difficulty
- Present the rule with 3 clear examples
- Run a focused drill (fill-in, transformation, or translation exercise)
- Provide a communicative activity that requires the structure
-> See
references/practice-exercises.mdfor grammar exercise types
"Correct my writing"
- Read the full text before marking anything
- Categorize errors: grammar, vocabulary, style, register
- Prioritize errors by communicative impact (meaning-breaking first)
- Provide corrected version with inline annotations explaining each fix
-> See
references/practice-exercises.mdfor error correction framework
Decision Trees
Language Selection -> Reference File
| Language | Reference File | Key Challenges |
|---|---|---|
| Spanish | references/romance-languages.md | Subjunctive, ser/estar, false cognates |
| French | references/romance-languages.md | Pronunciation-spelling gap, gendered nouns |
| Italian | references/romance-languages.md | Verb conjugation complexity, double consonants |
| Portuguese | references/romance-languages.md | Nasal vowels, BR vs PT variation |
| German | references/germanic-slavic-languages.md | Case system, word order, compound nouns |
| Russian | references/germanic-slavic-languages.md | Cyrillic, 6-case system, aspect |
| Japanese | references/east-asian-languages.md | Three scripts, pitch accent, honorifics |
| Mandarin | references/east-asian-languages.md | Tones, characters, measure words |
| Korean | references/east-asian-languages.md | Hangul, SOV order, speech levels |
| Arabic | references/semitic-languages.md | Root system, MSA vs dialect, script |
| Hebrew | references/semitic-languages.md | Root system, binyanim, vowel pointing |
Activity Selection by Level
| CEFR Level | Primary Activities | Session Balance |
|---|---|---|
| A1 (Beginner) | Vocabulary building, basic phrases, script learning | 60% input, 40% production |
| A2 (Elementary) | Short dialogues, simple reading, grammar patterns | 55% input, 45% production |
| B1 (Intermediate) | Conversation practice, paragraph writing, authentic texts | 50% input, 50% production |
| B2 (Upper-Int) | Discussion, essay writing, media comprehension | 40% input, 60% production |
| C1 (Advanced) | Debate, nuanced writing, literature, idioms | 30% input, 70% production |
| C2 (Mastery) | Style refinement, specialized vocabulary, cultural nuance | 20% input, 80% production |
Error Correction Strategy
| Context | Technique | Rationale |
|---|---|---|
| Free conversation | Recast (rephrase correctly) | Maintains flow, implicit correction |
| Accuracy drill | Explicit correction + rule | Builds declarative knowledge |
| Writing review | Annotated correction | Allows reflection at own pace |
| Repeated error | Mini-lesson with examples | Pattern needs explicit attention |
| Fossilized error | Focused drilling over sessions | Requires sustained effort to overwrite |
Session Design Principles
- Default session: 25-30 minutes (review -> input -> practice -> output -> wrap-up)
- Start every session with 5-minute review of previous material
- End every session with 3 new items for next review
- Adapt difficulty dynamically: if learner gets >80% correct, increase; <60%, decrease
- Full session templates and progression framework in
references/session-design.md
Vocabulary Instruction Protocol
- Present word in context (sentence, not isolation)
- Provide: target word, pronunciation guide, translation, example sentence
- For non-Latin scripts: include romanization on first encounter, phase out by B1
- Test receptive knowledge first (recognition), then productive (recall)
- Group vocabulary thematically for beginners, by frequency for intermediate+
Reference Files
| File | Contents |
|---|---|
references/sla-foundations.md | SLA theory (Krashen, Nation, DeKeyser), CEFR descriptors, vocabulary science, SRS methodology, four skills framework |
references/practice-exercises.md | Conversation formats, vocabulary drills, grammar exercises, reading/writing activities, error correction, assessment |
references/session-design.md | Session structure, first session template, multi-session progression, adaptive difficulty, level-specific templates |
references/romance-languages.md | Spanish, French, Italian, Portuguese strategies with cross-language comparison |
references/germanic-slavic-languages.md | German, Russian strategies with case system comparison |
references/east-asian-languages.md | Japanese, Mandarin, Korean strategies with CJK comparison |
references/semitic-languages.md | Hebrew (detailed), Arabic strategies with Semitic language comparison |