# Tov-learn — מערכת הלמידה האינטלגנטית

מערכת טיוטור אינטלגנטית המבוססת על Claude Code skills.

---

## Skill Modules

הסקיל `/learn` בנוי ממודולים נפרדים. כל מודול אחראי על תחום אחד ועצמאי לחלוטין.

| מודול | קובץ | תוכן |
|-------|------|------|
| Entry point + routing | `.claude/commands/learn.md` | Routing + TTS helper + Step 0-2 |
| Setup | `.claude/commands/learn/setup.md` | הגדרות ראשוניות, קול, global install |
| Resume | `.claude/commands/learn/resume.md` | Smart entry — suggests next action based on progress |
| Teaching | `.claude/commands/learn/teaching.md` | טעינת שיעור, Journey format, לולאת הוראה |
| Quiz | `.claude/commands/learn/quiz.md` | בחינה, ציונים, spaced repetition |
| Progress | `.claude/commands/learn/progress.md` | שמירת tutorials, knowledge map |
| Status | `.claude/commands/learn/status.md` | HTML dashboard — all lessons, scores, due reviews |
| Project Analysis | `.claude/commands/learn/project-analysis.md` | סריקת קוד, ראיון ארכיטקט, מפת HTML |
| Slides | `.claude/commands/learn/slides.md` | קריאה מילה במילה מסקריפטים, viewer אינטראקטיבי, TTS אוטומטי |
| Export | `.claude/commands/learn/export.md` | ייצוא כל נתוני התלמיד ל-ZIP — גיבוי/מעבר למכשיר אחר |
| Import | `.claude/commands/learn/import.md` | ייבוא נתוני תלמיד מ-ZIP — החלפה מלאה או הוספה בלבד |

סקריפטים תומכים נמצאים ב-`.claude/scripts/` (PowerShell — slide server, HTML generator).

**כלל פיתוח:** כל מודול עצמאי — לא מניחים שמודול אחר כבר נטען. מידע שמודול צריך — הוא קורא בעצמו. TTS helper מוגדר ב-`learn.md` ונטען לפני כל מודול.

---

## מבנה קורסים

```
courses/
  [course-name]/
    COURSE.md                          ← שם, תיאור, רשימת מודולים, course.path ברירת מחדל
    lessons/
      [XX-module-name]/
        [X.Y]-[lesson-name]/
          [X.Y]_script.txt             ← סקריפט (split by [מעבר שקף])
          [X.Y]_exercises.md           ← תרגילים
```

הקורס הפעיל היחיד הוא **AI Dev** — ברירת המחדל בכל מקום (setup, template, docs).

| קורס | תיקייה | course.path | סטטוס |
|------|--------|-------------|-------|
| AI Dev | `courses/ai-dev/` | `courses/ai-dev/lessons` | פעיל (ברירת מחדל) |
| AI Engineer | `courses/_archive/ai-engineer/` | `courses/_archive/ai-engineer/lessons` | בארכיון — לא מוצע ב-setup; נגיש רק דרך נתיב מותאם אישית |

---

## Data — per-learner (מחוץ ל-repo)

נשמר ב-`~/skill-tutor-tutorials/`:

```
settings.json                          ← שפה, TTS, course.name, course.path
learner_profile.md                     ← פרופיל אישי + לומד נוכחי
tutorials/lesson-X.Y.md               ← סיכומי שיעורים + Q&A
progress/lesson-X.Y.md                ← ציונים + תאריך חזרה מומלץ
topics/knowledge_map.md               ← מפת ידע מלאה
architectures/[project-name].html     ← מפות ארכיטקטורה
```

---

## הוספת מודול חדש

1. צור קובץ ב-`.claude/commands/learn/[module-name].md`
2. הוסף שורה לטבלת ה-Modules למעלה
3. הוסף routing ב-`learn.md` (Step 2 — Route table)
4. (אופציונלי) אם ההתקנה הגלובלית מופעלת — עדכן את רשימת הקבצים שמועתקים ב-`setup.md` סעיף F. ברירת מחדל: `/learn` רץ מתוך הריפו בלבד, ללא התקנה גלובלית.
