ב-Claude Code יש יותר מ-60 פקודות מובנות. /insights היא זו שמראה לכם איך אתם עובדים – ולא רק מה בניתם.
ב-Claude Code יש יותר מ-60 פקודות מובנות. מרבית המפתחים משתמשים ב-6 מהן באופן קבוע, ואולי ב-10 אם הם ממש שמים לב. הפקודות הפופולריות ביותר הן אלו ה"נראות לעין" – הפקודות שמייצרות פלט ישיר: לבנות משהו, לבצע סקירת קוד (review) או לדחוף שינויים (push).
לעומת זאת, הפקודות שדורשות מאיתנו לעצור לרגע ולצאת מתוך רצף העבודה עצמו – הן אלו שנוטות להישכח.
/insights היא בדיוק פקודה כזו.
מה היא עושה בפועל?
בסוף כל סשן (session) עבודה, /insights מייצרת דוח ניתוח מובנה שמתמקד בשלושה תחומים מרכזיים:
אזורי הפרויקט (Project Areas): באילו חלקים של ה-codebase נגעתם. אילו קבצים שונו, אילו מערכות קיבלו תשומת לב מיוחדת, ואילו אזורים נותרו ללא שינוי.
דפוסי אינטראקציה (Interaction Patterns): כיצד תקשרתם עם המודל במהלך הסשן. האם ההנחיות שלכם היו מפורטות או מעורפלות? האם עבדתם בצורה לינארית ומסודרת או שקפצתם בין משימות שונות? האם נאלצתם לתקן את אותו הדבר יותר מפעם אחת?
נקודות חיכוך (Friction Points): איפה הדברים החלו להאט. אלו הרגעים שדרשו מכם לנסח מחדש את הבקשות שלכם, המקומות שבהם נדרשו מספר סבבים של תיקונים, והפערים שנוצרו בין מה שהתכוונתם לבצע לבין מה שה-AI הבין בפועל.
החלק האחרון הוא המקום שבו מסתתר הערך האמיתי.
התובנה היא עליכם, לא על המודל
כשהסשן שלכם ב-Claude Code יוצא מהפסים, האינסטינקט הראשוני הוא להאשים את המודל: "הוא כל הזמן סטה מהנושא", "הוא לא הבין את הקונטקסט", "נאלצתי לתקן אותו ארבע פעמים".
אבל אלו רק סימפטומים. הפקודה /insights חושפת את שורש הבעיה.
במרבית המקרים, החיכוך נובע ישירות מהאופן שבו הגדרתם את המשימה (ה-specification) – ולא מחוסר יכולת של המודל. הנחיה מעורפלת מייצרת תוצאה מעורפלת. מגבלה שלא הוגדרה מראש הופכת להנחת עבודה עצמאית של ה-AI. קונטקסט חסר מתמלא על ידי הניחוש הטוב ביותר שהמודל מסוגל להפיק.
הבעיה היא שקשה להבחין בכך בזמן אמת. כשאתם עמוק בתוך פתרון הבעיה, אתם מתרכזים בקוד עצמו ולא בדרך שבה אתם מנחים את ה-AI. התיאור וההנחיות (ה-brief) מתחילים להישחק בלי שתרגישו, והסשן כולו מתדרדר יחד איתם.
הפקודה /insights הופכת את התהליך הזה לשקוף לחלוטין לאחר מעשה – בשפה פשוטה, ברורה, ועם דוגמאות ספציפיות מתוך הסשן שלכם.
איך להשתמש בזה?
מומלץ להריץ את הפקודה בסיומו של כל סשן שנמשך יותר מ-30 דקות. משימות קצרות ומהירות לא מייצרות מספיק נתונים כדי להפיק תובנות בעלות ערך. לעומת זאת, בסשנים מורכבים – כאלה שכללו החלטות ארכיטקטוניות, עבודה על קבצים מרובים, או כל משימה שבה חשתם חיכוך כלשהו – כדאי להריץ את הפקודה רגע לפני שאתם מנקים את הקונטקסט.
קראו קודם כל את נקודות החיכוך, ולאחר מכן את דפוסי האינטראקציה.
לאחר מספר סשנים כאלה, תתחילו לזהות דפוסים חוזרים: סוג מסוים של הנחיות שתמיד דורש סבב תיקונים, קונטקסט ספציפי שאתם תמיד שוכחים לספק מראש, או קטגוריות עבודה שבהן הגדרת המשימה שלכם (ה-spec) חלשה באופן עקבי.
זה לא קושי שפותרים באמצעות למידה של עוד כלי AI או פיצ'רים חדשים. זה משהו שמשפרים על ידי הבנה עמוקה יותר של הדרך שבה אנחנו חושבים, מתכננים ומנסחים רעיונות – עוד לפני שה-AI נוגע בשורת קוד אחת.
למה אף אחד לא מריץ את זה?
הפקודות שמשפרות את הפלט באופן ישיר הן ברורות ואינטואיטיביות – מריצים אותן ומקבלים תוצאה מיידית. לעומת זאת, פקודות שמשפרות את מתודולוגיית העבודה דורשות סוג אחר של חשיבה. הן דורשות מאיתנו להבין שהתהליך עצמו ראוי לבחינה ולשיפור, ולא רק התוצאה הסופית.
רוב המפתחים מסיימים סשן, סוגרים את הטרמינל וממשיכים הלאה. בין אם הקוד עובד ובין אם לא, כל מה שהוביל לתוצאה הזו – איכות ההנחיות, הפערים ב-spec והחיכוך שהצטבר לאורך שעתיים של עבודה – נותר שקוף ובלתי נראה.
הרצת /insights לוקחת בדיוק שתי דקות.
מה שהיא מייצרת עבורכם הוא מראה מדויקת: שיקוף ספציפי ברמת הסשן של האופן שבו אתם עובדים עם AI, ואיפה בדיוק שיטת העבודה הזו מתחילה להתפרק.
מפתחים מסתכלים על הפלט. ארכיטקטים מסתכלים על שניהם.
הקלידו /insights בסוף הסשן הארוך הבא שלכם. קראו בעיון את סעיף נקודות החיכוך, ותראו מה תגלו.