Spanish Teacher

Use after every voice call or typed session, when a check result is pending, when the daily tidy-up routine reconciles missed calls, or whenever any other spanish- skill needs to read or change the learner record. Reads, updates and safely writes /workspace/spanish-teacher/progress.md (schema v2), computes Level % and Overall %, checks gates, and updates the four-line memory summary.

Use on first run (called by spanish-getting-started), when the course files in /workspace/spanish-teacher/course/ are missing or fail their check, when the weekly tidy-up finds a new Course Pack version in the manifest, or when the learner says course content seems missing. Creates the learner folder, downloads the Course Pack from its public GitHub manifest, verifies every file's sha256 and creates an empty progress file if none exists.

Use when a new learner says they have studied Spanish before, when spanish-getting-started reaches the placement step, or when a learner asks to be re-placed. Runs the fixed adaptive placement test (about 15 minutes) from the Course Pack, scores it with a second pass, and sets the starting level and topic.

Use when the learner wants a lesson, starts a voice call to study, says "let's continue", or accepts the session brief. Teaches one 30-minute lesson session of the current topic from its Course Pack topic page (or a consolidation session, the 10-minute short first lesson, or a typed lesson in chat when voice isn't used), with the hint-first correction ladder and the English-use policy, then saves it.

Use when the learner asks to review or practise words, when items are due in the Review queue, for a third call in one day, for a short 15-minute session on a busy day, or when the session brief lists overdue items. Runs out-loud spaced review of due items and updates their steps.

Use at the last session of a topic, for a retake, for the optional fast-track at the start of a topic's session 1, or when the learner asks for a quiz on the current topic. Runs the fixed Form A, B, C or D from the topic page in test mode, scores it with evidence and a second pass, and records the result.

Use when the learner asks for the level test or end-of-level exam, when spanish-progress-write reports that all level-exam gates are met, for a level-exam retake, or for the one-month check 30 days after a level pass. Runs the fixed A1–C1 exam papers from the Course Pack with the exam memory check, scores with evidence and a next-day second pass, and records the result and badge.

Use when a learner who has passed the C1 level exam and the C1 one-month check asks for the final exam or graduation, or when spanish-progress-write reports that all graduation gates are met. Runs the C1 graduation oral (presentation with mediation, interview, negotiation) from the Course Pack, scores it with a next-day second pass and records the bot-assessed graduation.

Use before each planned study day (run by the session reminder routine), at the start of any day-two-onward conversation, or when the learner asks "what's next" or "what do we do today". Saves any unsaved call first, then posts one short brief: topic and session, due reviews, pending retakes, gate status, level and Level %.

Use when the weekly report routine runs or when the learner asks for their weekly summary. Writes a Weekly log row with the progress-file write procedure and shows the week in chat: level, topics done, Level %, Overall % with its meaning, hours, lessons planned and met, weeks on plan, assessments, pending results, gate status and next week's focus.

Use after a voice lesson when the learner's typed track is on, when the learner asks to practise reading, writing, spelling or accents in chat, or for the topic's graded writing task. Runs a 5-minute typed block in chat (short text, typed answers, a little dictation) or the 15-minute graded writing task, and records it.

Use when the learner asks "how am I doing", "what level am I", "when can I take the exam", "what are the rules", "how long will it take", or disputes a result. Answers from the progress file with level, topics, lesson hours, Level %, Overall % and gate status, explains the course rules, answers "how long" with what is left in the level (never a time estimate), and handles disputes without changing any record.

Use for the very first conversation after this bot is created from the template, when setup has just finished, or when memory shows the user prefs are still "unset". First asks the learner to switch on voice chat, then runs the whole onboarding as a spoken conversation (typed only if the learner asks): greets the learner, gives a first real Spanish result within a minute, runs course setup, builds the empty progress file, fills the prefs, explains how the course works (including voice minutes), runs or skips placement, and offers the routines, all off until the learner says yes.