מה קורה כשמכניסים את קלוד קוד לצוות פיתוח אמיתי

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

כתבנו את הדף הזה אחרי כמה חודשים של עבודה יומיומית עם סוכן בתוך תהליך פיתוח קיים, כולל האתר שאתם קוראים בו עכשיו. הוא נבנה ב-Next.js עם תמיכה דו-לשונית מלאה בעברית ובאנגלית, כולל RTL, מערכת תוכן מבוססת Supabase ופאנל ניהול. חלק ניכר מהעבודה הזו נעשה בליווי סוכן, וחלק ממנה נזרק ונכתב מחדש בידיים.

מה באמת מתקצר

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

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

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

איפה זה נשבר

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

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

מה עדיין חייב אדם

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

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

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

איך נראה תהליך שעובד

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

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

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

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