מדריך קלוד קוד למתחילים - חלק 5: CLAUDE.md - המוח הקבוע של האייג'נט

📌 סדרת מדריכי Claude Code למתחילים:

1. חלק 1: מה זה Claude Code?
2. חלק 2: התקנה וחיבור
3. חלק 3: הצעד הראשון שלך
4. חלק 4: מתחת למכסה המנוע
5. חלק 5: CLAUDE.md - המוח הקבוע (עמוד זה)

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

הבעיה שאף אחד לא מספר לנו עליה

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

הוא לא זוכר את הפרויקט שלנו. לא את הכללים שהגדרנו אתמול. ולא את הטעות שתיקנו לפני שעה.

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

אז איך פרויקט שומר על הזיכרון שלו בין סשנים שונים?

פשוט כותבים אותו. בקובץ אחד: CLAUDE.md.

מהו בעצם קובץ CLAUDE.md

קובץ CLAUDE.md הוא קובץ טקסט פשוט שנמצא בתיקיית הפרויקט שלנו.

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

אם סקיל (skill) הוא יכולת שנטענת לפי דרישה, קובץ CLAUDE.md הוא בדיוק ההפך: הוא הזהות שפועלת תמיד.

לזה בדיוק אנשים מתכוונים כשהם אומרים הנדסת הקשר (context engineering): החלטה מודעת ומכוונת מה האייג'נט יודע לפני שהוא מתחיל לעשות משהו.

מה נכנס בפנים

כדאי לשמור על הקובץ קצר וממוקד. קובץ CLAUDE.md טוב הוא לא מסמך ארוך, אלא אוסף של החלטות. יש בו ארבעה חלקים עיקריים:

1. מטרה (Purpose) - מהו הפרויקט הזה, בשורה אחת או שתיים.
2. טכנולוגיות וכלים (Stack and tools) - ממה הוא בנוי, ובאילו כלים כדאי לאייג'נט להשתמש או להימנע מהם.
3. כללי התנהגות (Behavior rules) - מה "תמיד" עושים, ממה "אף פעם" לא מגיעים, ומה לעשות כש-X קורה. זה הלב של הקובץ.
4. מגבלה קשיחה אחת (One hard limit) - משהו שהאייג'נט לעולם לא יעשה על דעת עצמו. שער האישור (approval gate) שלנו.

החלק האחרון הוא חובה. זה הגבול ששומר שהאייג'נט יפעל בדיוק איפה שאנחנו רוצים.

דוגמה קטנה (זה כל מה שצריך)

# Project: My Recipe Site

## What this is
A simple website for sharing my family recipes.

## Tools
- Plain HTML and CSS. No frameworks.

## Rules
- Always explain a change in plain language before making it.
- Never delete a file without asking me first.
- When I ask for a new recipe page, copy the existing template and fill it in.

## Hard limit
- Never publish anything live without my explicit approval.

קצר. ברור. כל שורה היא החלטה שקיבלנו. זהו קובץ CLAUDE.md אמיתי.

איך ליצור את הקובץ שלך

יש שני נתיבים פשוטים לעשות את זה, ואפשר להשתמש בשניהם יחד.

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

נתיב 2 - שימוש בסקיל הייעודי. יש סקיל שנבנה בדיוק בשביל המטרה הזו: setup-claude-md. הוא מוביל אותנו לאורך כתיבת הקובץ צעד אחר צעד ושואל את השאלות הנכונות. פשוט מפעילים אותו ועונים על השאלות תוך כדי תנועה.

טיוטה שמכילה רק תיאור פרויקט פשוט אינה מספיקה. הערך האמיתי טמון בחוקי ההתנהגות ובמגבלה הקשיחה. זה מה שמשנה בפועל את האופן שבו האייג'נט מתנהג.

כלל הזהב של הסדרה כולה

הנה המשפט שכדאי לקחת איתנו מעבר למדריך הזה:

לעולם אל תיתן לאייג'נט להחליט מה הפרויקט צריך להיות.
תן לו להחליט רק איך לבנות אותו.

מה הצעד הבא?

← חזרה למדריך 4: מתחת למכסה המנוע