An AI-powered Spanish tutor that runs inside your terminal. Built on the Language Transfer "Thinking Method" — no app, no API, just markdown files that turn any LLM agent into a patient, adaptive Spanish teacher.
"It's not about remembering — it's about knowing how to find it."
A collection of carefully crafted markdown files that give an AI agent the personality, teaching methodology, knowledge base, and memory system to tutor you in Spanish from A1 (absolute beginner) to C2 (near-native).
It works inside Gemini CLI, Claude Code, or any agent that reads workspace files.
The tutor doesn't lecture. It guides you to discover Spanish through questions — just like the Language Transfer audio course:
Teacher: "Preparation" in Spanish is "preparación."
If you take off the "-tion" and add "-r"...
what verb do you get?
Student: Preparar?
Teacher: Exactly. And "confirmation"?
Student: Confirmación... so "to confirm" is... confirmar?
Teacher: Now you'll never forget it.
Every concept is taught through pattern discovery, block-by-block sentence building, and contextual etymology — never through grammar tables or rote memorization.
cd Language-Transfer/
gemini
# Just say "let's start a lesson"cd Language-Transfer/
claude
# Just say "let's start a lesson" — CLAUDE.md auto-loads the tutorThe tutor will:
- Assess your level through natural conversation (not a test)
- Start teaching at your edge — where you know things but start to struggle
- Remember everything across sessions via local markdown files
The most important design distinction. The workspace has two categories:
These define WHO the tutor is and WHAT it knows. Same for every student.
| File | Purpose |
|---|---|
IDENTITY.md |
Name, version, purpose |
SOUL.md |
Personality & philosophy |
AGENT.md |
Teaching method, session flow, behavioral rules (the heart) |
GEMINI.md |
Auto-config + non-negotiable rules for Gemini CLI |
CLAUDE.md |
Auto-config + non-negotiable rules for Claude Code |
knowledge/concept-map.md |
A1→C2 topic index with prerequisites |
knowledge/teaching-method.md |
The 6 Language Transfer principles |
knowledge/teaching-examples.md |
10 few-shot examples from the transcript |
knowledge/error-patterns.md |
Common mistakes by CEFR level |
knowledge/topics/*.md (27 files) |
Individual topic teaching guides, loaded on demand |
These track the individual student's progress. Start empty, grow over time.
| File | Purpose | How It Changes |
|---|---|---|
LEARNER.md |
Student profile: level, interests, goals | Filled in during first session, refined over time |
memory/MEMORY.md |
Living progress tracker (~80 lines max) | Updated during and after every session |
memory/sessions/YYYYMMDD.md |
Individual session logs | New file created each session |
Clone the repo → get the full tutor brain but a blank learner profile. The tutor assesses you fresh and builds your unique learning path.
Built on the 6 Language Transfer principles:
| Principle | What It Means |
|---|---|
| Pattern Discovery | Never state rules — guide the student to notice patterns through examples |
| Block-by-Block Building | Complex sentences are built piece by piece, not presented whole |
| Error as Compass | Mistakes reveal thinking patterns — use them to teach, don't just correct |
| Contextual Webs | Connect words through etymology and meaning ("confirmar" = "con" + "firma") |
| Adaptive Pacing | Speed up when the student is nailing it, slow down when they're struggling |
| Conversational Practice | Real conversations, not drills — use the student's interests |
The tutor remembers you across sessions:
- MEMORY.md — compact profile: your level, solid concepts, shaky areas, recurring error patterns, what teaching approaches work for you
- Session notes — detailed logs of each lesson with specific errors, breakthroughs, and next-session suggestions
- Error fingerprinting — if you make the same mistake 3+ times, it becomes a tracked pattern the tutor actively works on
- Student meta-feedback — tell the tutor "too many hints" or "more conversation" and it adapts permanently
Memory saves happen proactively during sessions, not just at the end — so even if you close the terminal mid-lesson, your progress is preserved.
LLMs are trained to be helpful. A tutor must sometimes be deliberately unhelpful. We had to add explicit rules with BAD/GOOD examples showing what NOT to do.
Instead of one question and waiting, the tutor asks 2-3 at once. Rule #1: "ONE question per message. Ask, then STOP."
Critical behavioral rules must go at the TOP of the first file the model reads. We moved them to GEMINI.md / CLAUDE.md as "NON-NEGOTIABLE RULES."
Small models break character constantly. The tutor needs high instruction-following capability for Socratic restraint and patience.
Users close terminals without saying goodbye. Memory must save incrementally during the session, not just at exit.
Once teaching subjunctive, it drills subjunctive forever. Topic rotation rule: switch after 5-6 exchanges, then circle back.
Students can give meta-feedback about teaching style. Methodology stays fixed; delivery adapts.
Markdown formatting in conversation feels robotic. Rule: "Write like a person talking, not a document."
The paradox: The hardest part isn't telling the agent what to teach. It's telling it what NOT to do. The agent already knew Spanish grammar. What it didn't know was when to shut up.
| Tier | Models | Notes |
|---|---|---|
| ⭐ Best | Gemini 3.1 Pro, Claude Opus 4.6, GPT-4o | Follow complex persona instructions faithfully |
| ✅ Good | Gemini 3 Flash, Claude Sonnet 4.6 | Solid balance of quality and speed |
| Flash Lite, Haiku, GPT-4o-mini | Too fast/cheap to maintain teaching discipline |
- Teaching methodology inspired by Language Transfer by Mihalis Eleftheriou — a brilliant, free language course that teaches through guided discovery rather than memorization
- This project is an homage to Mihalis's work. If you enjoy this tutor, please support the original Language Transfer project
- The original Language Transfer courses (Spanish, French, Italian, German, Greek, Arabic, Turkish, Swahili, Music) are all free at languagetransfer.org
MIT