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

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

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

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

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

תבנית התחלה:

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

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

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


## מהניסיון שלי

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

## בקצרה

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



## שאלות נפוצות

### מה ההבדל בין שיחת תכנון לבין כתיבת קוד?

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

### האם צריך ADR לכל שינוי קטן?

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

### מה צריך לכלול הניסוי הראשון?

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

## על הכותב

עופר שפירא - The Israeli AI Agency - התאמה והתקנת סוכני AI לעסקים קטנים בישראל, בעברית, עם ליווי לאורך זמן.