כשסוכן AI מתחיל סשן חדש, שיחה חדשה, יום חדש או אחרי קריסה, הוא לא זוכר כלום ממה שקרה קודם. אצל RomaFlow מדדנו את זה: סוכנים שמתחילים בלי סיכום מצב מבזבזים כמעט חצי מזמן הסשן רק על גילוי מחדש, קריאת קבצים, ניחוש מה כבר נעשה, ולפעמים אפילו עשייה כפולה של עבודה. הפתרון שאנחנו מיישמים בכל פרויקט נקרא HANDOFF-first: בסוף כל סשן הסוכן כותב קובץ HANDOFF.md קצר, והסשן הבא קורא אותו לפני כל פעולה אחרת. זה משנה לגמרי את קצב העבודה.
הכי חשוב, בקצרה 👇
- סוכן בלי סיכום מצב מבזבז כמעט חצי מהסשן על גילוי מחדש של ההקשר
- HANDOFF.md הוא קובץ קצר שנכתב בסוף כל סשן: מה נעשה, מה נשאר, מה הצעד הבא
- הסשן הבא קורא את הקובץ לפני כל פעולה אחרת, ולא סורק מחדש את כל הפרויקט
- התוצאה: פחות טוקנים, פחות זמן אתחול, פחות עבודה כפולה
ניהול מצב סוכן AI: למה כל אתחול עולה זמן וכסף
ברירת המחדל של רוב הסוכנים היא לא לזכור כלום מעבר לחלון ההקשר הנוכחי. כשאתם פותחים סשן חדש, הסוכן לא יודע אילו קבצים כבר נגעו בהם, אילו החלטות כבר התקבלו, ואיפה בדיוק העבודה נעצרה. הוא מתחיל בסריקה: קורא קבצים, מנסה להבין את המבנה, ולפעמים חוזר על משימה שכבר בוצעה כי אין לו שום סימן שהיא הסתיימה. זה בדיוק הפער שניוול מצב סוכן AI אמור לסגור, לא באמצעות זיכרון קבוע ומורכב, אלא באמצעות פתק קצר שמעביר את המידע הקריטי הלאה.
איך בונים HANDOFF.md שבאמת עובד
המפתח הוא לא בכמות המידע אלא במיקוד שלו. HANDOFF.md טוב עונה על שלוש שאלות בלבד: מה בוצע בסשן הזה, מה נשאר לעשות, ומה הצעד הראשון שהסשן הבא צריך לבצע, בלי ניחושים. אצלנו הכלל הוא שהסוכן כותב את הקובץ הזה כפעולה אחרונה, ממש לפני שהסשן נסגר, וקורא אותו כפעולה ראשונה כשהוא נפתח מחדש. ההבדל בפועל: במקום לפתוח עשרות קבצים כדי לשחזר הקשר, הסוכן קורא סיכום אחד ומתחיל לעבוד תוך דקות ספורות. זה גם מקטין את הסיכוי לשגיאות, כי הצעד הבא כתוב במפורש ולא נשען על ניחוש.
מרמת הסשן לרמת הפרויקט
HANDOFF-first פותר בעיה ברמת הסשן הבודד: מה קרה ב-24 השעות האחרונות ומה השלב הבא. זו אותה בעיה בקנה מידה קטן יותר כמו שmemory.md פותר ברמת הפרויקט כולו, שני כלים משלימים, לא מתחרים. כשאתם מחליטים אם המשימה הבאה צריכה סוכן בודד, לולאה או תהליך עבודה שלם, שווה גם לבדוק את כלל ההחלטה בין לולאה, תת-סוכן ותהליך עבודה, כי מבנה העבודה משפיע ישירות על איך HANDOFF.md צריך להיראות.
| מדד | בלי HANDOFF | עם HANDOFF |
|---|---|---|
| זמן אתחול ממוצע לסשן | 20-30 דקות של סריקה חוזרת | 2-3 דקות, קריאת קובץ אחד |
| עלות טוקנים לאתחול | אלפי טוקנים על קריאת קבצים וניחוש ההקשר | כמה מאות טוקנים על סיכום ממוקד |
| שגיאות ועבודה כפולה | שכיחות, משימות מבוצעות פעמיים | נדירות, הצעד הבא ידוע מראש |
רוצים לראות איך בונים מערכת HANDOFF?
הכלים שבנינו ייפתחו לכולם בחינם בקרוב, רשמו את עצמכם לגישה מוקדמת, אל תישארו מאחור.
