Afrexai Language Mastery

Language Learning Mastery

Complete adaptive language acquisition system. Covers any human language with structured curricula, spaced repetition, immersive conversation practice, grammar acquisition, pronunciation coaching, cultural fluency, exam prep, and long-term progress tracking.

Phase 1: Learner Profile & Placement

Learner Profile YAML

Before starting, build a complete learner profile:

learner_profile:
  target_language: ""
  dialect: ""                    # e.g., Brazilian Portuguese, Egyptian Arabic, Kansai Japanese
  native_language: ""
  other_languages: []            # existing languages + proficiency
  
  current_level:
    cefr: ""                     # A0/A1/A2/B1/B2/C1/C2
    self_assessed: ""            # beginner/elementary/intermediate/advanced
    placement_score: null        # from placement test below
    
  goal:
    primary: ""                  # travel/conversation/professional/academic/heritage/cultural
    exam: ""                     # DELE, DELF, JLPT, HSK, TestDaF, IELTS, etc.
    timeline: ""                 # "trip in 3 months", "exam in 6 months"
    daily_time: ""               # minutes per day available
    
  style_preferences:
    learning_type: ""            # conversational/structured/immersive/visual/auditory
    error_correction: ""         # immediate/gentle/delayed/minimal
    formality: ""                # casual/standard/formal
    humor: true                  # include humor and cultural anecdotes?
    
  progress:
    sessions_completed: 0
    vocabulary_learned: 0
    grammar_points_covered: []
    current_unit: 1
    streak_days: 0
    last_session: ""
    weak_areas: []
    strong_areas: []

Placement Test Protocol

For non-absolute-beginners, run a 5-minute diagnostic:

Level 1 (A1): "Translate: Hello, my name is [X]. I am from [country]."
Level 2 (A1+): "Describe what you did yesterday in 3 sentences."
Level 3 (A2): "What would you do if you won the lottery? (3 sentences)"
Level 4 (B1): "Explain the pros and cons of working from home."
Level 5 (B1+): "Read this short paragraph and summarize in the target language."
Level 6 (B2): "Express your opinion on [current topic]. Include counterarguments."
Level 7 (C1): "Explain a complex concept from your field in the target language."

Scoring: Place learner at the HIGHEST level they can attempt with >60% accuracy. Mark errors as weak areas for targeted practice.

CEFR Level Mapping

Phase 2: Curriculum Architecture

Unit Structure (Each Unit = ~1 Week at 30 min/day)

unit:
  number: 1
  theme: "Meeting People"       # Thematic context
  
  vocabulary:
    core_words: 20              # Must-learn words
    bonus_words: 10             # Nice-to-know
    phrases: 10                 # Fixed expressions
    
  grammar:
    new_point: "Present tense regular verbs"
    review_points: []           # From previous units
    
  skills:
    listening: "Understand simple introductions"
    speaking: "Introduce yourself and ask basic questions"
    reading: "Read a simple profile/bio"
    writing: "Write a short self-introduction"
    
  cultural_note: "Greeting customs — handshake vs cheek kiss vs bow"
  
  assessment:
    vocabulary_quiz: true
    grammar_exercise: true
    conversation_practice: true
    mini_project: "Record a 30-second self-introduction"

Level-Based Curriculum Map

A1 Curriculum (Units 1-12)

1. Greetings & introductions
2. Numbers, dates, time
3. Family & descriptions
4. Food & ordering
5. Directions & transportation
6. Shopping & prices
7. Home & daily routine
8. Weather & seasons
9. Hobbies & free time
10. Health & body
11. Jobs & workplace basics
12. Review & level-up assessment

A2 Curriculum (Units 13-24) 13. Telling stories (past tense) 14. Making plans (future) 15. Comparisons & preferences 16. Travel & accommodation 17. Phone & email communication 18. Feelings & opinions 19. Media & entertainment 20. Environment & nature 21. Education & learning 22. Celebrations & traditions 23. Problem-solving conversations 24. Review & level-up assessment

B1 Curriculum (Units 25-36) 25. Current events discussion 26. Hypothetical situations 27. Giving advice & suggestions 28. Formal vs informal register 29. Narrative & storytelling 30. Debate & persuasion basics 31. Technology & society 32. Work culture & professional life 33. Arts, literature & film 34. Regional dialects & variations 35. Complex explanations 36. Review & level-up assessment

B2+ Curriculum: Shifts from structured units to topic-based immersion, exam prep tracks, professional specialization, or literary/cultural deep dives based on learner goals.

Phase 3: Vocabulary Acquisition System

The 5-Encounter Method

Every new word must be encountered 5 different ways before it's "learned":

Encounter 1: INTRODUCTION — Word + translation + example sentence
Encounter 2: RECOGNITION — See it in context, identify meaning
Encounter 3: PRODUCTION — Use it in a sentence (guided)
Encounter 4: APPLICATION — Use it in free conversation
Encounter 5: REVIEW — Recall it after 24+ hours (spaced repetition)

Vocabulary Card Format

vocab_card:
  word: "hablar"
  translation: "to speak/talk"
  pronunciation: "ah-BLAR"
  part_of_speech: "verb"
  example: "Yo hablo español un poco."
  example_translation: "I speak Spanish a little."
  related_words: ["conversación", "idioma", "decir"]
  common_mistakes: "Don't confuse with 'charlar' (to chat, more informal)"
  mnemonic: "HABLAr — imagine someone blabbing (talking a lot)"
  frequency_rank: "top 100"
  level: "A1"

Spaced Repetition Schedule

Vocabulary Drill Types

1. Translation drill — Target → Native and Native → Target
2. Fill-the-blank — Sentence with missing word
3. Multiple choice — 4 options, one correct
4. Picture description — Describe a scenario using target words
5. Odd one out — Which word doesn't belong in this group?
6. Synonym/antonym match — Find the pair
7. Context guess — Read a sentence, guess the underlined word's meaning
8. Speed round — 10 words in 60 seconds, translation only

Word Frequency Strategy

First 100 words → Covers ~50% of everyday text
First 500 words → Covers ~70% of everyday text
First 1,000 words → Covers ~80% of everyday text
First 3,000 words → Covers ~90% of everyday text
First 5,000 words → Covers ~95% of everyday text

Rule: Always teach high-frequency words first. Don't teach "butterfly" before "want."

Phase 4: Grammar Acquisition

Grammar Introduction Protocol

For every new grammar point:

1. EXPOSURE — Show 3-5 example sentences. Don't explain the rule yet.
   Ask: "What pattern do you notice?"
   
2. DISCOVERY — Guide learner to figure out the rule themselves.
   "When do we use [form A] vs [form B]?"
   
3. EXPLICIT RULE — State the rule clearly with a simple formula.
   "Subject + [verb stem] + [ending] = [meaning]"
   
4. CONTROLLED PRACTICE — Fill-in-the-blank, transformation drills.
   "Change these sentences from present to past tense."
   
5. FREE PRACTICE — Use the grammar in conversation.
   "Tell me about your last vacation using past tense."
   
6. ERROR ANALYSIS — Review common mistakes with this structure.
   "Most learners say [X] but native speakers say [Y]. Here's why."

Grammar Difficulty Sequencing

Universal acquisition order (most languages follow this):
1. Present tense (affirmative)
2. Negation
3. Questions (yes/no, then WH-)
4. Plural/singular
5. Articles/determiners
6. Past tense (simple/common)
7. Future (simple)
8. Adjective agreement/position
9. Object pronouns
10. Past tense (complex/perfect)
11. Comparatives/superlatives
12. Conditional
13. Subjunctive/mood
14. Passive voice
15. Relative clauses
16. Reported speech

Adjust for language-specific structures:
- Japanese: particles before verb conjugation
- Chinese: measure words before complex sentences
- Arabic: root system before advanced morphology
- German: cases before complex word order

Error Correction Strategies

Correction frequency by level:

• A1-A2: Correct only meaning-breaking errors. Fluency > accuracy.
• B1: Add grammar recasts for current-unit grammar points.
• B2: Increase precision. Correct register and word choice.
• C1+: Full correction. Native-level accuracy is the goal.

Phase 5: Conversation Practice

Conversation Session Structure (15-20 min)

1. WARM-UP (2 min)
   - "How was your day?" in target language
   - Quick vocab review: 5 words from last session
   
2. SCENARIO (10 min)
   - Role-play a real situation at current level
   - Tutor plays native speaker, learner navigates
   - Push slightly beyond comfort zone (i+1)
   
3. EXPANSION (3 min)
   - Introduce 2-3 new words that came up naturally
   - One grammar observation from the conversation
   
4. WRAP-UP (2 min)
   - "What was the hardest part?"
   - Assign one thing to practice before next session

Conversation Scenarios by Level

A1 Scenarios:

• Ordering coffee/food at a café
• Asking for directions to the train station
• Checking into a hotel
• Meeting someone at a party (introductions)
• Buying something at a shop

A2 Scenarios:

• Describing symptoms at a pharmacy
• Calling to make a restaurant reservation
• Telling a friend about your weekend
• Asking a coworker about their job
• Negotiating at a market

B1 Scenarios:

• Job interview (simplified)
• Explaining a misunderstanding
• Planning a trip with a friend
• Returning a defective product
• Giving directions to your house

B2 Scenarios:

• Debating a news topic
• Explaining your work to someone outside your field
• Handling a complaint (as staff or customer)
• Discussing a book or film in depth
• Navigating cultural misunderstandings

C1+ Scenarios:

• Negotiating a contract or deal
• Giving a presentation with Q&A
• Mediating a disagreement between two people
• Telling a complex story with humor and detail
• Discussing philosophy, politics, or ethics

Immersive Conversation Rules

1. Stay in the target language — if learner switches to native, gently redirect
2. Match the learner's level + 1 — use vocabulary slightly above their current level
3. Paraphrase before translating — try to explain unknown words IN the target language first
4. Celebrate communication — understanding each other matters more than perfect grammar
5. Natural pace — don't slow down unnaturally; instead, repeat or rephrase

Phase 6: Pronunciation & Phonetics

Sound System Analysis

For each target language, identify:

pronunciation_map:
  new_sounds: []              # Sounds that don't exist in learner's native language
  tricky_pairs: []            # Sounds that are distinct in target but merged in native
  stress_pattern: ""          # Fixed, moveable, tonal?
  intonation: ""              # Rising questions? Falling statements? Musical patterns?
  common_mistakes: []         # Top 5 pronunciation errors for speakers of learner's L1

Example for English speaker learning Spanish:

pronunciation_map:
  new_sounds: ["rr (trilled r)", "ñ"]
  tricky_pairs: ["b/v (same sound in Spanish)", "ser/estar vowels"]
  stress_pattern: "Predictable with rules (penultimate syllable default)"
  intonation: "Less dramatic than English; questions rise less"
  common_mistakes:
    - "Adding 'uh' after final consonants (es-pañ-OL not es-pan-YOL-uh)"
    - "Pronouncing 'h' (it's always silent)"
    - "English 'r' instead of Spanish tap/trill"
    - "Diphthong reduction (saying 'o' instead of 'ue' in 'puede')"
    - "Vowel sounds too long/short"

Pronunciation Practice Techniques

1. Minimal pairs — practice sounds that are easily confused
   • "pero" (but) vs "perro" (dog) — single r vs trilled rr
2. Shadow reading — repeat after a model sentence immediately
3. Tongue twisters — target specific difficult sounds
4. Record & compare — record yourself, compare to native model
5. Backward build-up — for long words, start from the end syllable and add backwards
   • "ción" → "cación" → "nicación" → "municación" → "comunicación"

Tone Languages (Chinese, Vietnamese, Thai, etc.)

Additional framework for tonal languages:
1. Teach tone FIRST — before vocabulary
2. Use tone pairs, not isolated tones
3. Practice tones in context (sentences > words > syllables)
4. Mark tones explicitly in all written materials
5. Common mistake: focusing on individual tone perfection vs tone contrast

Phase 7: Cultural Fluency

Cultural Context Integration

Every unit includes one cultural insight:

cultural_note:
  topic: "Personal space & physical contact"
  language: "Spanish"
  region: "Spain vs Latin America"
  insight: "In Spain, two cheek kisses are standard greetings even between people who just met. In many Latin American countries, one kiss or a handshake is more common. Business contexts are more formal everywhere."
  vocabulary: ["beso", "abrazo", "saludo"]
  pragmatic_tip: "When in doubt, let the local person initiate the greeting style."

Pragmatic Competence Topics (by level)

Language-Specific Cultural Quick Guides

Build a mini-guide for each target language covering:

• Formal/informal address rules (when to use tú/usted, tu/vous, du/Sie)
• Common gestures and body language
• Gift-giving customs
• Dining etiquette basics
• Conversation topics to avoid
• Holidays and celebrations to know
• Pop culture references that every native speaker knows

Phase 8: Reading & Listening Skills

Graded Input Strategy

Active Reading Protocol

1. PRE-READ: Scan title, headings, images. Predict content.
2. FIRST READ: Read for gist. Don't stop for unknown words.
   → "What is this about in one sentence?"
3. SECOND READ: Identify unknown words. Guess from context first.
   → Circle words you can't guess, look up only those.
4. COMPREHENSION CHECK: Answer questions about the text.
5. LANGUAGE HARVEST: Pick 5 useful words/phrases to add to your deck.
6. PRODUCTION: Write a response, summary, or opinion about the text.

Listening Skills Progression

Level 1: Listen with transcript visible
Level 2: Listen first, then check transcript
Level 3: Listen only, answer comprehension questions
Level 4: Listen and take notes in target language
Level 5: Listen to native-speed content with regional accents

Phase 9: Writing Skills

Writing Task Progression

Writing Feedback Framework

For every piece of writing, provide feedback in this order:

1. CONTENT (what they said)
   - Was the task completed? All points addressed?
   - Is the content logical and organized?

2. COMMUNICATION (was it clear?)
   - Would a native speaker understand the message?
   - Is the register appropriate?

3. LANGUAGE (accuracy)
   - Grammar errors (list top 3 with corrections)
   - Vocabulary upgrades (suggest 2-3 better word choices)
   - Sentence variety (any repetitive patterns?)

4. NEXT STEP
   - One specific thing to practice for improvement

Phase 10: Exam Preparation Tracks

Supported Exam Frameworks

Exam Prep Protocol

exam_prep:
  target_exam: ""
  target_level: ""
  exam_date: ""
  weeks_available: 0
  
  plan:
    phase_1_diagnostic:
      duration: "Week 1"
      actions:
        - "Take a practice test under real conditions"
        - "Score each section"
        - "Identify weakest section (focus 40% of time here)"
        - "Identify strongest section (maintain with 15% of time)"
    
    phase_2_skill_building:
      duration: "Weeks 2 through [N-2]"
      actions:
        - "Daily vocabulary from exam word list (20 words/day)"
        - "Grammar review of exam-tested structures (1/day)"
        - "One practice section per day (rotate skills)"
        - "Weekly full practice test"
    
    phase_3_exam_strategy:
      duration: "Final 2 weeks"
      actions:
        - "Full practice tests under timed conditions"
        - "Review only highest-impact errors"
        - "Time management practice (minutes per section)"
        - "Day before: light review only, early sleep"

Exam-Specific Tips

Multiple choice (JLPT, HSK): Read all options before answering. Eliminate obviously wrong answers first. When unsure, pick the least "extreme" option.

Writing section (DELE, DELF): Plan for 5 minutes before writing. Use discourse markers (firstly, however, in conclusion). Check for subject-verb agreement last.

Speaking section (IELTS, DELE): Paraphrase the question to buy thinking time. Use the STAR method for describing experiences. If you forget a word, describe it instead of freezing.

Listening section (all exams): Read questions BEFORE the audio plays. Mark answers during first listen, confirm during second. Don't panic if you miss one question — move on.

Phase 11: Progress Tracking

Session Log Format

session_log:
  date: ""
  session_number: 0
  duration_minutes: 0
  
  vocabulary:
    new_words: []
    reviewed_words: []
    mastered: []
    struggling: []
    
  grammar:
    practiced: ""
    accuracy: ""           # rough %, based on exercises
    
  conversation:
    topic: ""
    comfort_level: ""      # 1-5
    new_phrases_learned: []
    
  pronunciation:
    focus: ""
    improvement: ""
    
  homework:
    assigned: ""
    completed: ""
    
  notes: ""

Weekly Progress Report

📊 Weekly Progress — Week [X]

🎯 Level: [CEFR] (tracking toward [target])
📚 Vocabulary: [X] words learned this week ([Y] total)
🗣️ Conversation: [X] sessions, comfort level [1-5]
📝 Grammar: [topic] — accuracy [X]%
🔥 Streak: [X] days

✅ Strengths this week:
- [specific skill that improved]

⚠️ Focus areas:
- [specific weakness to target]

📋 Next week's goals:
1. [specific goal]
2. [specific goal]
3. [specific goal]

Level-Up Assessment

Every 12 units, run a comprehensive assessment:

1. Vocabulary test: 50 words from the level (target: 80%+)
2. Grammar test: 10 exercises covering level structures (target: 70%+)
3. Listening comprehension: 2 passages with questions (target: 70%+)
4. Speaking: 5-minute conversation on a level-appropriate topic
5. Writing: One writing task appropriate to level

Pass criteria (all must be met):
- Vocabulary: ≥80%
- Grammar: ≥70%
- Listening: ≥70%
- Speaking: Can sustain conversation with <20% L1 use
- Writing: Task completed with level-appropriate accuracy

If passed: Move to next level 🎉
If 1 area fails: Targeted remediation for 1 week, then retest that skill
If 2+ areas fail: Continue current level with focused practice plan

Phase 12: Motivation & Habit Building

Streak & Gamification

🔥 Daily streak tracking
⭐ "Word of the day" — one interesting word with cultural context
🏆 Level milestones with celebration messages
📈 Weekly progress chart (vocabulary count, session count)
🎯 Monthly challenges ("Learn 10 food words", "Have a 5-minute conversation")

Motivation Recovery

When learner says "I haven't practiced in a while" or shows signs of dropping off:

1. No guilt — "Welcome back! Your brain didn't forget everything."
2. Quick diagnostic — test 10 recent words to see what stuck
3. Easy win — start with something they'll succeed at
4. Reduce load — "Let's do just 5 minutes today"
5. Reconnect to goal — "Remember, you wanted to [goal]. Here's how far you've come."

The 4-Skill Balance Rule

Every week should include all 4 skills:
- Listening: 25% of study time
- Speaking: 25% of study time
- Reading: 25% of study time
- Writing: 15% of study time
- Vocabulary/Grammar: 10% of study time

Imbalance warning signs:
- "I can read but not speak" → more conversation practice
- "I can understand but can't produce" → more writing + speaking
- "I know words but can't make sentences" → more grammar in context

Phase 13: Special Learning Contexts

Heritage Language Learners

• Often understand more than they can produce
• Skip basic listening comprehension; focus on production
• Address cultural identity sensitivity — "correct" language vs home language
• Build confidence in register-switching (formal/informal)

Language for Travel (Crash Course)

Priority vocabulary (100 survival words):
1. Greetings (5)           11. Help/emergency (5)
2. Please/thank you (5)    12. Time (10)
3. Numbers 1-20 (20)       13. Weather (5)
4. Food ordering (10)      14. Compliments (5)
5. Directions (10)         15. Basic adjectives (10)
6. Transportation (5)      16. "I don't understand" (3)
7. Hotel/accommodation (5) 17. "Do you speak English?" (2)

Teach these in 10 sessions. Focus on pronunciation and key phrases, not grammar.

Children (Ages 5-12)

• Games, songs, stories — NOT grammar rules
• TPR (Total Physical Response) — act out vocabulary
• Shorter sessions (10-15 min)
• Repetition through fun, not drills
• Celebrate every attempt

Professional/Business Language

business_track:
  email_templates: ["introduction", "follow-up", "complaint", "request"]
  meeting_language: ["agreeing", "disagreeing politely", "presenting", "asking for clarification"]
  phone_calls: ["answering", "leaving messages", "scheduling"]
  presentations: ["opening", "transitions", "closing", "Q&A handling"]
  small_talk: ["weather", "weekend", "travel", "sports — culture-specific topics"]
  industry_vocabulary: "[specific to learner's field]"

Phase 14: Multi-Language Support Notes

Language Family Advantages

If learner knows...    → These languages are easier:
Spanish               → Portuguese (85% similar), Italian (80%), French (75%)
French                → Italian, Spanish, Portuguese, Romanian
German                → Dutch (90%), Swedish, Norwegian, Danish
Japanese              → Korean (grammar similar), Chinese (kanji overlap)
Hindi                 → Urdu (mutually intelligible), Nepali, Bengali (partial)
Arabic                → Hebrew (shared roots), Persian (loan words), Turkish (loan words)
Russian               → Ukrainian, Polish, Czech, Bulgarian
Mandarin Chinese      → Cantonese (written), Japanese (kanji), Korean (loan words)

Language-Specific Teaching Adaptations

Character-based languages (Chinese, Japanese, Korean):

• Teach reading system separately from conversation
• Use romanization as training wheels, then phase out
• Chinese: Pinyin → characters (radicals → components → full characters)
• Japanese: Hiragana → Katakana → basic Kanji (first 100) → ongoing Kanji
• Korean: Hangul (can be learned in 2-3 sessions — it's systematic)

Right-to-left languages (Arabic, Hebrew, Persian, Urdu):

• Practice writing direction explicitly
• Use both directions in exercises
• For Arabic: decide early on MSA vs dialect (or both)

Tonal languages (Chinese, Vietnamese, Thai, Burmese):

• Tone-first approach — master the tone system before heavy vocabulary
• Minimal pair drills with tones
• Record yourself constantly

Agglutinative languages (Turkish, Finnish, Hungarian, Japanese, Korean):

• Teach morpheme-by-morpheme building
• Use color-coding for different affixes
• Practice building long words from parts

Quick Reference: Natural Language Commands