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, אל תמשיך איתם כאילו הם תקפים. יש להתייחס רק למבנה החדש.