CLAUDE.md לפרויקט
המוסכמות, פקודות הבנייה וכללי הסקירה של הצוות — בקובץ אחד שנכנס לגיט ועובד לכל מי שמושך את הפרויקט.
שעה 4סדנת יום · שש שעות
סדנת יום בת שש שעות ב-Claude Code — הכלי שבו סוכן עובד ישירות על הקבצים, המסמכים ומאגרי הקוד שלכם, ולא בתוך חלון צ׳אט. מיועדת לצוותי פיתוח, לאנליסטים ולמי שכבר עבר את שלב הצ׳אט ומחפש את המדרגה הבאה. עובדים על מאגר או תיקייה אמיתיים שלכם, לא על פרויקט הדגמה.
רקע
רוב האנשים שמשתמשים ב-AI לקוד עושים את זה בהעתק־הדבק: מעתיקים קטע לצ׳אט, מקבלים תשובה, מדביקים חזרה. זה עובד, וזה נשבר ברגע שהמשימה נוגעת ביותר מקובץ אחד — כי המודל לא ראה את שאר הפרויקט, לא הריץ את הבדיקות, ולא יודע מה נשבר.
Claude Code עובד אחרת. הוא רץ אצלכם — בטרמינל, בתוך VS Code או JetBrains, או בדפדפן — ופועל בלולאה: אוסף הקשר מהפרויקט, מבצע פעולה, ומאמת את התוצאה, שוב ושוב עד שהמשימה נסגרת. הוא קורא קבצים, עורך אותם, מריץ פקודות ובדיקות, ועובד מול git. אתם יכולים לעצור אותו באמצע ולכוון מחדש בכל רגע.
וזו בדיוק הסיבה שהסדנה היא יום ולא שלוש שעות: היכולת לגעת בקבצים ולהריץ פקודות היא גם החוזק וגם מה שמחייב הגדרה. חצי מהיום מוקדש ליכולות, וחצי לשכבה שהופכת אותן לבטוחות ולעקביות בצוות — מצב תכנון, הרשאות, זיכרון פרויקט וכללים משותפים.
מבנה הסדנה
שלוש שעות מחולקות לשלושה חלקים. בכל חלק יש הסבר קצר ואחריו תרגול על חומר אמיתי שלכם — לא הרצאה של שלוש שעות עם תרגיל בסוף.
לפני המפגש: מבררים על איזה מאגר או תיקייה נעבוד, איזו סביבת פיתוח בשימוש, ומה מדיניות המידע שלכם. בנוסף מוודאים עם ה-IT שההתקנה וההרשאות מאושרות — בלי זה מבזבזים את השעה הראשונה על תקלות.
דוגמאות
אלה דוגמאות מסדנאות קודמות. אצלכם הן ייראו אחרת, כי הן נבנות על התהליכים שעולים במיפוי שלפני המפגש.
המוסכמות, פקודות הבנייה וכללי הסקירה של הצוות — בקובץ אחד שנכנס לגיט ועובד לכל מי שמושך את הפרויקט.
שעה 4סקירת קוד לפי הצ׳קליסט שלכם, כתיבת בדיקות בפורמט שלכם, או הכנת תיאור PR. נכתב פעם אחת, רץ אצל כולם.
שעות 5–6סקריפט שמעבד CSV, עיבוד לוגים, או תחזוקת תיעוד — החלק שמוכיח לאנליסטים שזה לא כלי לפיתוח בלבד.
שעות 2–3הפרטים
כל מה שנשאלים לפני שסוגרים תאריך, במקום אחד. אם משהו כאן לא מתאים לכם — אפשר להתאים, ונאמר את זה בשיחה.
שכבות ההרחבה
| השכבה | מה זה | מתי משתמשים |
|---|---|---|
| CLAUDE.md | קובץ זיכרון של הפרויקט שנטען בתחילת עבודה | מוסכמות, פקודות בנייה וכללים שתמיד רלוונטיים |
| סקילים ופקודות | הוראות ארוזות שמופעלות בפקודה, או לפי הקשר | תהליך שחוזר: סקירה, בדיקות, תיאור PR |
| סוכני משנה | סשן נפרד עם הקשר משלו שמחזיר סיכום | מחקר או סקירה שלא צריכים למלא את ההקשר הראשי |
| Hooks | פקודות שרצות אוטומטית באירועים מוגדרים | כשחייבים שמשהו יקרה תמיד — פורמט, בדיקה, חסימה |
| MCP | חיבור למערכות וכלים חיצוניים בפרוטוקול פתוח | גישה למערכת פניות, למאגר או לשירות פנימי |
למי זה מתאים
הסדנה עובדת הכי טוב כשבחדר יושבים אנשים שחולקים את אותם תהליכים. אלה הקבוצות שרואות ממנה הכי הרבה:
Claude Code רץ עם ההרשאות של מי שמפעיל אותו, ולכן ארגונים יכולים להגדיר מראש מה מותר: רשימות היתר לכלים ולפקודות, הגבלת חיבורי MCP, מצב הרשאות התחלתי, ובידוד ברמת מערכת ההפעלה.
ההגדרות האלה נאכפות ברמת הארגון ולא תלויות בכך שכל מפתח יזכור להגדיר נכון. בשעה האחרונה נעבור עליהן, ועדיף שנציג IT יהיה בחדר.
שאלות שחוזרות
מסלולים סמוכים
אפשר להזמין את הסדנה הזאת לבד, ואפשר לשלב אותה במסלול. בשני המקרים היא רצה על הכלים והתהליכים של הארגון שלכם.
צעד ראשון
שיחה קצרה על הפרויקט, על סביבת הפיתוח ועל מדיניות המידע, ותיאום ההתקנה מול ה-IT לפני המפגש.