איך לתת לסוכן הקידוד מבוסס ה-AI שלך לולאת משוב שתופסת את הבאגים של עצמו

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

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

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

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

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

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

אפשרות 1: פשוט לבקש, בתצורת הפרויקט שלך

הגרסה הדורשת הכי מעט מאמץ היא שורה בקובץ CLAUDE.md או AGENTS.md שלך (קובץ ההוראות בטקסט פשוט שרוב הסוכנים קוראים בעת ההפעלה):

## Verification
After any code change, run `npm run typecheck && npm test`.
If either fails, fix the cause and re-run before reporting done.

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

אפשרות 2: להפוך את זה לאוטומטי עם hook

Hooks של Claude Code מאפשרים לך להריץ פקודת shell בתגובה לאירועי מחזור חיים, ללא תלות בשאלה אם המודל זוכר לעשות זאת. הרלוונטי כאן הוא PostToolUse, שמופעל אחרי שהסוכן עורך קובץ. כפי שמדריך hooks מעשי מנסח זאת, PostToolUse בנוי לתגובות — עיצוב, רישום (logging), הרצת בדיקות — והפלט שלו מוזרק בחזרה אל ההקשר של הסוכן כדי להשפיע על הצעד הבא שלו.

הנה hook מינימלי שמריץ את בודק הטיפוסים שלך אחרי כל עריכת קובץ ומעביר כשלים בחזרה לסוכן. בקובץ .claude/settings.json:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npm run typecheck"
          }
        ]
      }
    ]
  }
}

כעת המחזור אוטומטי: הסוכן כותב קוד ← ה-hook מריץ tsc ← אם יש שגיאת טיפוס, ההודעה זורמת בחזרה כהקשר ← הסוכן מתקן אותה ← ה-hook רץ שוב. מסמך העזר של hooks מתעד כיצד קוד היציאה (exit code) השונה מאפס והפלט מוצגים למודל. לולאה זו רצה בכל כתיבה, ללא צורך בהנחיה.

שמור על הלולאה מהירה וממוקדת

לולאת משוב מועילה רק אם היא מהירה. כמה כללי אצבע:

• הרץ את הבדיקות הזולות בכל עריכה, ואת היקרות לעיתים רחוקות יותר. בדיקת טיפוסים או linter על הקובץ שהשתנה היא מהירה. חבילת אינטגרציה מלאה אינה כזו — הגבל אותה מאחורי hook מסוג Stop (כשהסוכן מסיים תור) או פקודה ידנית, ולא בכל הקשה.
• התמקד במה שהשתנה. הרצת כל חבילת הבדיקות שלך אחרי שינוי CSS בשורה אחת מבזבזת זמן ומציפה את ההקשר. במקום שבו הכלים שלך מאפשרים זאת, מקד לקבצים המושפעים.
• הפוך כשלים לקריאים. הסוכן מתקן רק את מה שהוא יכול לקרוא. linters ובודקי טיפוסים עם הודעות שגיאה ברורות וממוקמות (file:line: message) נותנים למודל בדיוק את מה שהוא צריך; "build failed" גנרי לא נותן.

דוגמה קונקרטית של לפני ואחרי

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

עם הלולאה: אותו שינוי שם מפעיל את typecheck בשמירה. tsc מדווח Cannot find name 'oldFn' במקום הקריאה שפוספס. השגיאה נוחתת בהקשר, הסוכן פותח את הקובץ הרביעי, מתקן את ההפניה, והבדיקה הבאה עוברת — הכול עוד לפני שהוא מודיע לך שסיים.

המסקנה

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