📘 תיעוד 128

ערכת אלוף

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

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

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

#תפקיד האלוף

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

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

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

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

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

#מה שווה לשתף

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

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

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

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

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

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

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

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

Learned today that @-mentioning a directory works. I pointed it at
@src/components/ and asked which components were missing tests, and it
surfaced two I had forgotten about.

I configured a Stop hook so I receive a desktop notification when a long
task completes. I started a refactor, stepped away, and was notified when
it finished. Configuration is in the thread.

Plan mode is the reason I am comfortable using this on code that matters.
Press Shift+Tab until you see "plan"; it lays out the changes it proposes
without editing your source.

#היו האדם שאליו פונים

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

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

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

Colleague: How did you get it to find that race condition?

Champion: I asked, "The test in @tests/scheduler.test.ts is flaky, figure
out why," and it traced two unjoined promises in the scheduler. Try the
same phrasing on your test.

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

תשובה כגון "נסו מצב Plan, לחצו על Shift+Tab עד שתראו אותו" שימושית יותר ברגע מאשר קישור לתיעוד. אם האדם צריך עומק נוסף אחר כך, הוא ימצא אותו בעצמו. כרגע הוא צריך את הדבר האחד שמשחרר אותו.

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

#הגדילו את המעגל

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

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

#תוכנית לשלושים יום

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

1. שבוע 1: זריעת הערוץ

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

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

2. שבוע 2: התחלת הקצב

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

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

3. שבוע 3: צימוד ואיחוד

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

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

4. שבוע 4: העברה

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

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

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

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

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

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

#גיליון עזר מהיר

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

[!TIP]

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