9 בדיקות לקובץ ההוראות

1. מה קרה

ב-24 ביולי 2026 פרסמה אנת\'רופיק שהיא הסירה יותר מ-80% מפרומפט המערכת של Claude Code עבור המודלים החדשים, בלי ירידה מדידה בבדיקות הקוד. הצוות שכתב את הפרומפט הזה מחק את רובו, ופרסם את הכללים שלפיהם החליט מה הולך.

• רובנו עושים בדיוק הפוך: כל טעות של הסוכן הופכת לעוד שורה בקובץ ההוראות.
• הקובץ רק גדל, אף אחד לא מוחק, והמודל משתפר בינתיים.
• התוצאה: אתם משלמים קונטקסט על כללים שנכתבו למודל שכבר לא קיים.

2. תשע הבדיקות

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

• למי נכתבה השורה? אם היא נכתבה לפני דור מודלים, יש סיכוי טוב שהיא כבר לא נחוצה.
• זה איסור או שיקול דעת? "תכתוב כמו הקוד שמסביב" מנצח עשר שורות של אל תעשה.
• זה נוהל או עובדה? תהליך ארוך הוא סקיל, לא שורה בקובץ.
• ההוראה הזאת מופיעה עוד מקום? המודל החדש קולט אותה מפעם אחת.
• זה משהו שכל מפתח כבר יודע? בקובץ נשארות המלכודות של המאגר, לא הידע הכללי.
• אפשר להחליף את התיאור בקוד? טסט קיים או קובץ דומה מסבירים יותר מפסקה.
• הדוגמה עדיין עובדת בשבילכם? ממשק כלי ברור מלמד את השימוש בלי דוגמאות.
• מה זה עולה? בדקו כמה הסקילים והקובץ תופסים לפני שאתם מוסיפים עוד.
• מה נשאר? קובץ קצר שמכיל רק את מה שמפתיע במאגר הזה.

3. הפרומפט המוכן

פתחו סשן בקלוד קוד בתוך המאגר, והדביקו:

עבור על קובץ ההוראות של המאגר הזה (CLAUDE.md או AGENTS.md, כולל קבצים מקוננים).

לכל שורה או סעיף, ענה על תשע השאלות:
1. נכתב לדור מודלים ישן?
2. איסור שאפשר להחליף בשיקול דעת?
3. נוהל שצריך לעבור לסקיל?
4. כפילות של הוראה שמופיעה במקום אחר?
5. ידע כללי שכל מפתח מכיר?
6. תיאור שאפשר להחליף בהפניה לקוד, לטסט או לקובץ קיים?
7. דוגמה שכבר לא נחוצה?
8. מה העלות שלה בקונטקסט ביחס לתועלת?
9. אם היא נשארת, מה המלכודת הספציפית שהיא מונעת?

החזר טבלה עם: השורה, ההמלצה (השאר / קצר / העבר לסקיל / מחק), והנימוק.

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

4. מה לא למחוק

קיצור הוא לא המטרה. הוראה שמונעת טעות חוזרת שווה יותר מהטוקנים שהיא צורכת.

• מלכודות ספציפיות למאגר: פקודת בנייה לא סטנדרטית, שירות שצריך לרוץ קודם, קובץ שנראה מיותר ואסור למחוק.
• החלטות שכבר שילמתם עליהן בבאג. זה בדיוק מה שהקובץ נועד לזכור.
• גבולות הרשאה: מה מותר לסוכן לעשות לבד ומה דורש אישור שלכם.
• סקיל שהוצאתם מהקובץ עדיין צריך להיות טוב. העברה היא לא מחיקה.

5. איך בודקים שהצלחתם

אחרי הקיצוץ, תנו לסוכן משימה אמיתית שהצליחה קודם, ובדקו שהיא עדיין מצליחה. אם משהו נשבר, החזירו שורה אחת, לא את כל הקובץ. למדידה של הקונטקסט עצמו יש מדריך נפרד: /context מראה מה תופס את החלון.

• בדקו על משימה שאתם כבר יודעים איך אמורה להיראות, לא על משימה חדשה.
• החזרה של שורה אחת בכל פעם מלמדת אתכם מה באמת החזיק את ההתנהגות.
• שורה שהחזרתם פעמיים היא מועמדת טובה להפוך לסקיל עם שם.

6. מקורות

הכללים במדריך מבוססים על הפרסום של אנת'רופיק ועל התיעוד הרשמי של Claude Code.

https://claude.com/blog/the-new-rules-of-context-engineering-for-claude-5-generation-models
https://code.claude.com/docs/en/skills
https://code.claude.com/docs/en/memory
https://code.claude.com/docs/en/context-window