# AGENTS.md

קובץ זה מיועד ל-GPT / AI / סוכן אוטומטי שעובד עם הריפו.

## לפני כל פעולה
חובה לקרוא קודם:
1. `RULES.md`
2. `metadata/index.json`
3. `metadata/taxonomy.json`
4. `metadata/authors.json`

## מהו הריפו הזה
זהו מאגר קבצים מסודר לחומרי מתמטיקה.
זה אינו אתר ואינו אפליקציה.

## מה לעשות כשמוסיפים קובץ
1. להבין אילו סיווגים ידועים מהמשתמש.
2. כל דבר לא ידוע לסמן כ-`unknown`.
3. לחשב או לזהות `content_hash`.
4. לבדוק אם `content_hash` כבר מופיע ב-`metadata/index.json`.
5. אם `content_hash` כבר קיים — לא להוסיף קובץ חדש.
6. אם `content_hash` לא קיים — לבחור מיקום פיזי יחיד בלבד.
7. לא לשכפל קבצים.
8. אם הקובץ שייך לכמה נושאים — לשמור כמה נושאים ב-`topics`.
9. מותר ששמות קבצים יחזרו.
10. אסור שתוכן קובץ יחזור.
11. להוסיף רשומה ל-`metadata/index.json`.
12. אם הסיווג החדש אינו קיים בטקסונומיה — לעדכן גם `metadata/taxonomy.json` ואת `RULES.md`.
13. אם מדובר בייבוא ממקור חיצוני — לבצע קודם בדיקת רלוונטיות תוכנית ומתמטית.
14. אם יש ספק אם הקובץ שייך למאגר — לא לייבא אותו אוטומטית.

## איך לחשוב על בקשות של המשתמש
- אם המשתמש מבקש שליפה לפי נושא/כיתה/שנה/שאלון — יש לסנן מהאינדקס.
- אין להסתמך רק על תיקיות.
- יש להתייחס ל-`primary_category` וגם ל-`topics`.
- אם בודקים כפילות, יש להשוות `content_hash` ולא `file_name`.

## סדר עדיפויות
1. דרישות המשתמש בשיחה הנוכחית.
2. `RULES.md`.
3. מצב הקבצים בפועל בריפו.

## מצב מאומת נוכחי
כרגע יש במאגר שלוש רשומות פעילות ומאומתות בלבד:
1. `מאגר ז`
2. קובץ כיתה ח על יחס / פרופורציה / קנה מידה
3. קובץ כיתה ח של דפי סיכום על יחס / פרופורציה / קנה מידה

כל קובץ אחר שלא מופיע באינדקס התקף אינו חלק מהמצב הפעיל.

## דוגמאות
### דוגמה 1
בקשה: "תן לי את כל האלגברה של כיתה ט'"

יש לסנן:
- `grade = 9`
- וגם `primary_category = algebra` או `topics` שכוללים אלגברה

### דוגמה 2
בקשה: "תן לי את כל בגרויות 3 יח"ל"

יש לסנן:
- `track = bagrut`
- `unit_level = 3-unit`
- `bagrut_questionnaire in [381, 382]`

### דוגמה 3
בקשה: "תן לי את כל המבחנים של כיתה ח' סוף שנה"

יש לסנן:
- `grade = 8`
- `document_type = exam`
- `exam_kind = end-of-year`

## כלל ברזל
אם מצאת קובץ ישן או הוראה ישנה שסותרים את `RULES.md`, אל תמשיך איתם כאילו הם תקפים. יש להתייחס רק למבנה החדש.