📘 תיעוד 92

ערכת מוביל

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

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

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

#תפקיד המוביל

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

#מה זה אמור לעלות לכם

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

#שתפו את מה שאתם מגלים

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

#מה כדאי לשתף

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

דוגמאות לטכניקות שניתנות לשימוש חוזר:

• "למדתי שאזכור של תיקייה באמצעות @ עובד. כיוונתי אותו אל @src/components/ ושאלתי לאילו רכיבים חסרות בדיקות, וזה הציף שניים שפספסתי."
• "מצב תכנון (Shift+Tab) מציג בדיוק באילו קבצים יבוצעו שינויים לפני שנעשית עריכה כלשהי, וזו הסיבה שאני מרגיש בנוח להשתמש בו על קוד משותף."
• "הגדרתי Stop hook כך שאני מקבל התראת שולחן עבודה כשמשימה ארוכה מסתיימת. ההגדרה נמצאת בשרשור."
• "הרצת /init מייצרת CLAUDE.md מתוך המאגר, כך שהעוזר מפסיק לשאול שוב ושוב על המוסכמות שלנו."

#איפה לשתף את זה

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

#הפורמט שעובד

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

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

למדתי היום שאזכור תיקייה באמצעות @ עובד. כיוונתי אותו אל
@src/components/ ושאלתי לאילו רכיבים חסרות בדיקות,
וזה הציף שניים ששכחתי מהם.

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

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

#היו האדם שאותו שואלים

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

#ענו באמצעות פרומפט ולא באמצעות הסבר

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

עמית: איך גרמת לו למצוא את ה-race condition הזה?

מוביל: שאלתי, "The test in @tests/scheduler.test.ts is flaky, figure out why", וזה איתר שתי הבטחות (promises) שלא בוצע להן join ב-scheduler. נסו את אותו הניסוח על הבדיקה שלכם.

#הצביעו על התכונה ולא על התיעוד

תגובה כגון "נסה את מצב תכנון (plan mode), לחץ על Shift+Tab עד שתראה אותו" שימושית יותר באותו הרגע מאשר קישור לתיעוד. אם האדם יצטרך העמקה נוספת מאוחר יותר הוא ימצא אותה בעצמו, כרגע הוא זקוק לדבר היחיד שישחרר את החסימה שלו.

#שאלות שסביר להניח שתשמעו

#הרחיבו את המעגל

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

#דפוסים שנוטים לעבוד

#תוכנית פעולה לשלושים יום

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

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

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

2. שבוע 2: התחלת הקצב התחילו את השרשור השבועי של שיתוף והדגמה (show-and-tell), ענו על כל שאלה בפומבי, ושתפו מיומנות מותאמת אישית אחת או קטע מתוך CLAUDE.md.

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

3. שבוע 3: עבודה בזוגות ואיחוד מידע הציעו שניים או שלושה סשנים קצרים של עבודה בזוגות (pairing), ואחדו את השאלות והתשובות הנפוצות ביותר להודעת שאלות ותשובות (FAQ) נעוצה.

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

4. שבוע 4: העברת המקל זהו מוביל שני ושתפו סיכום קצר של מה שעובד ומה שלא עם ראש הצוות או מנהל המערכת שלכם.

   סימן לכך שזה עובד: שאלות בערוץ נענות על ידי אנשים שאינם אתם.

#כשמישהו רוצה להעמיק

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

#מענה לחששות נפוצים

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

#דף עזר מהיר

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

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