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

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

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

למה קפיצה ישירה לקוד נכשלת

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

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

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

שלב 1: חקרו במצב לקריאה-בלבד

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

התחילו בכך שתבקשו מהסוכן להבין את הקוד, לא לשנות אותו:

Read /src/auth and explain how we handle sessions and login.
Also look at how we manage environment variables for secrets.

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

שלב 2: בקשו תוכנית, ואז לחצו עליה

ברגע שהסוכן חקר, בקשו תוכנית קונקרטית לפני כל קוד:

I want to add Google OAuth login. What files need to change?
What's the session flow? Write a step-by-step plan — don't write code yet.

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

• "מה קורה אם ה-callback של ה-OAuth נכשל באמצע הדרך?"
• "כבר יש לנו helper בשם refreshToken ב-src/auth/tokens.ts — השתמש בו מחדש במקום לכתוב חדש."
• "השאר את זה לזרימת ה-login בלבד. אל תיגע בקוד איפוס הסיסמה הקיים."

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

שלב 3: בנו עם דרך לאמת

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

Implement the OAuth flow from your plan. Write a test for the callback
handler covering the failure case, run the test suite, and fix any failures.

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

שלב 4: דעו מתי לדלג על התכנון

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

רשת ביטחון: תקנו כיוון מוקדם והשתמשו ב-checkpoints

גם עם תוכנית טובה, סוכנים סוטים. שני הרגלים שומרים אתכם בשליטה:

• הפסיקו ברגע שהוא יוצא מהמסלול. אל תחכו שהסוכן יסיים גישה שגויה. ב-Claude Code, Esc עוצר אותו באמצע פעולה עם הקשר משומר כך שתוכלו לנתב מחדש.
• השתמשו ב-checkpoints כדי להתנסות בחופשיות. Claude Code מצלם תמונת מצב של הקבצים שלכם לפני כל שינוי, כך שתוכלו לומר לסוכן לנסות משהו מסוכן, ואם זה לא עובד, לחזור אחורה (Esc Esc או /rewind) ולנסות גישה אחרת. (Checkpoints עוקבים אחר העריכות של הסוכן עצמו, לא תהליכים חיצוניים — הם נוחות, לא תחליף ל-git.)

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

השורה התחתונה

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