CLAUDE.md ו-AGENTS.md: הנחיות קבועות והוקים שהופכים סוכן AI לעובד

מה זה CLAUDE.md, ולמה סוכן צריך הנחיות קבועות

לכל סוכן AI שאתם עובדים איתו באופן שוטף יש דברים שאתם רוצים לחזור עליהם בכל שיחה מחדש: באיזו שפה לכתוב, איפה לשמור קבצים, איך נראה דוח טוב. במקום לחזור עליהם בכל הודעה, כותבים אותם פעם אחת בקובץ קטן בתיקייה של הסוכן. ב-Claude Code הקובץ הזה נקרא CLAUDE.md, ובכל פעם שמפעילים את הסוכן מתוך התיקייה, ההנחיות מהקובץ נטענות אוטומטית בתחילת השיחה ומלוות את כל העבודה.

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

CLAUDE.md מול AGENTS.md: אותו רעיון, שני שמות

בסוכנים אחרים, כמו Codex של OpenAI, אותו קובץ נקרא AGENTS.md. AGENTS.md הוא פורמט פתוח לשיתוף הנחיות עבודה בין סוכנים, מעין README שנכתב לסוכנים במקום לבני אדם.

גם Claude Code תומך ב-AGENTS.md בגרסאות עדכניות, אבל מה שנטען בפועל תלוי בקיומם של קובצי CLAUDE.md ובהגדרה Project instructions של Claude Code. לפי התיעוד של אנטרופיק, כברירת מחדל Claude Code קורא את AGENTS.md רק כשאין קובץ CLAUDE.md בתיקייה או מעליה, ואפשר לשנות זאת דרך ההגדרה הזו. מי שעובד עם כמה סוכנים צריך לבדוק בפועל מה נטען. פתרון נפוץ הוא לשמור את ההנחיות ב-AGENTS.md וליצור CLAUDE.md קצר שמייבא אותו, כך ששני הסוכנים קוראים בדיוק את אותן הנחיות.

מה כותבים בקובץ ההנחיות

קובץ ההנחיות הוא כמו דף הנהלים שמקבל עובד חדש ביום הראשון. אלה הדברים שנכון לכתוב בו:

1. מי הסוכן ומה התפקיד שלו בארגון

משפט או שניים שמסבירים לסוכן מה הוא עושה ובשביל מי.

2. כללי עבודה

באיזו שפה לכתוב, היכן לשמור קבצים ובאיזה פורמט. כללים כאלה חוסכים את התיקונים הקטנים שחוזרים בכל שיחה.

3. העדפות אישיות

סגנון כתיבה, מבנה של דוחות, הדרך שבה אתם אוהבים לקבל תוצרים.

4. בדיקות לפני שמסיימים משימה

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

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

מה לא כותבים בו, ולמה לשמור אותו קצר

את הסקילים ואת ההנחיות למשימות ספציפיות לא מכניסים לקובץ הזה. סקיל הוא תיקייה עם הוראות עבודה למשימה מסוימת, והסוכן טוען אותו רק כשהוא צריך. קובץ ההנחיות, לעומת זאת, נטען תמיד, ולכן הוא אמור להישאר קצר: התוכן שלו תופס מקום בקונטקסט, כלומר בכל המידע שהמודל רואה ברגע נתון. התיעוד של Claude Code ממליץ לשאוף לפחות מ-200 שורות בכל קובץ CLAUDE.md, ומציין שקובץ ארוך יותר צורך יותר קונטקסט ומפחית את ההיענות להנחיות.

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

מה זה הוקים (Claude Code hooks)

הוק (Hook) הוא מנגנון שמפעיל פעולה אוטומטית ברגע שמתרחש אירוע מוגדר בעבודת הסוכן: לפני שהוא משתמש בכלי מסוים, אחרי שהוא משתמש בו, או כשהוא מסיים משימה. מי שמכיר את המושג Webhook יבין מיד במה מדובר: זה אותו רעיון, רק בתוך עבודת הסוכן. ב-Claude Code מגדירים הוקים בקובץ ההגדרות (settings.json), ולכל רגע כזה יש אירוע משלו, למשל PreToolUse לפני שימוש בכלי, PostToolUse אחריו ו-Stop כשהסוכן מסיים.

כמה דוגמאות לשימוש:

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

שני סוגי הוקים: פעולת המשך ובדיקה לפני

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

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

בקשה מול אכיפה: למה שורה בקובץ לא מספיקה

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

דוגמה מהמוצר שלנו: שרת ה-MCP של MyBusiness, שדרכו מחברים את Claude או ChatGPT למערכת ה-CRM, תומך בקבלה, ביצירה ובעדכון של מידע, ואין בו כלי מחיקה בכלל. בנוסף, החיבור יורש את הרשאות המשתמש, ואדמין המערכת יכול להגביל לכל משתמש בנפרד אילו פעולות מותרות לו דרך MCP. זו בדיוק ההבחנה: לא לבקש מהסוכן שלא ימחק, אלא לא לתת לו כלי מחיקה מלכתחילה.

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