המדריך מהריל · מילת הקוד: זיכרון
איך Claude ו־Codex ממשיכים מאותה נקודה בלי להעביר צ׳אט
בריל ראיתם משימה שמתחילה ב־Claude וממשיכה ב־Codex. אין כאן זיכרון פנימי משותף ואין העברה של היסטוריית צ׳אט. יש חוזה עבודה מקומי: קבצים ברורים שמתעדים מה הוחלט, מה הושלם ומה הצעד הבא.
1.העיקרון: לא זיכרון משותף, אלא מסירה מסודרת
שני סוכנים יכולים לעבוד על אותו פרויקט בלי לראות את אותה שיחה. כדי שזה יעבוד, כל מידע שחשוב למשימה הבאה צריך להישמר בקובץ שהפרויקט מחזיק, ולא להישאר רק בתוך חלון הצ׳אט.
הקבצים לא מחליפים שיקול דעת. הם נותנים לסוכן הבא נקודת פתיחה אמינה: מה כבר נבדק, אילו החלטות התקבלו, מה אסור לשנות ומה נותר לעשות.
2.מגדירים חוזה עבודה אחד
צרו מסמך הנחיות מרכזי בפרויקט, למשל CLAUDE.md או AGENTS.md. הוא צריך לכלול את גבולות העבודה, כללי האיכות, מיקום הקבצים החשובים וכללים לפעולות חיצוניות כמו פרסום, רכישה או שינוי מערכת חיה.
אל תשמרו שם סיסמאות, מפתחות API, כתובות Webhook או מידע של לקוחות. הסוכן צריך לדעת איפה נמצאים הכללים, לא לקבל גישה סודית בתוך קובץ הנחיות.
- כתבו מה מותר לסוכן לבצע לבד ומה מחייב אישור.
- ציינו אילו תיקיות הן פרויקטים פעילים ואסור להזיז או למחוק.
- הוסיפו כללי בדיקה לפני מסירה, למשל בדיקת build או מעבר ידני על תצוגה מקדימה.
3.שני קבצים שמחזיקים את מצב העבודה
NEXT_STEPS הוא הלוח הקצר של ההמשך. בתחילתו צריכה להיות פעולה אחת שאפשר לבצע עכשיו, אחריה מה נמצא בעבודה ומה מגיע בהמשך. כך סוכן חדש לא צריך לנחש מה דחוף.
WORKLOG הוא היומן המצטבר. מוסיפים אליו מה בוצע, איפה נשמרה התוצאה, אילו החלטות התקבלו ומה עדיין פתוח. לא מוחקים ממנו היסטוריה כדי לפנות מקום.
4.טוענים רק את ההקשר שצריך בתחילת סשן
בפרויקט הזה יש hook מקומי של SessionStart. הוא קורא את ראש NEXT_STEPS, את הכותרת האחרונה ב־WORKLOG ואת אינדקס הזיכרון המקומי, ומכניס לסשן החדש תקציר קצר בלבד.
לא חייבים לבנות hook כדי להתחיל. אפשר לפתוח כל משימה חדשה בקריאה של שלושת המסמכים. hook הופך את הצעד הזה לעקבי כאשר הפרויקט גדל, אבל צריך לבדוק אותו מקומית לפני שסומכים עליו.
- השאירו את התקציר קצר: פעולה נוכחית, מצב, החלטות והגבלות.
- שמרו את המקורות המלאים בקבצים כדי שאפשר יהיה לפתוח אותם לפי הצורך.
- ודאו שה־hook נכשל בשקט אם קובץ חסר, ואינו מדפיס מידע רגיש.
5.שומרים את הכללים עקביים בין הסביבות
אם Claude ו־Codex משתמשים בתבניות הוראות שונות, הגדירו מקור אחד שממנו נוצרים קובצי ההתאמה. בפרויקט eDigi, למשל, scripts/codex-sync.py מסנכרן את שכבת Codex מתוך מקורות ההנחיות.
אל תריצו סקריפט סנכרון שהגיע מפרויקט אחר בלי לקרוא אותו. ודאו אילו קבצים הוא משנה, שמרו גיבוי לפני החלפה, והריצו קודם בדיקת מצב אם הסקריפט תומך בה.
6.בודקים את המסירה בלי לחשוף את העסק
יצרו בדיקה קטנה עם נתוני דמה: ודאו שה־hook קורא את קובצי המצב, שהסנכרון מזהה חוסר התאמה אם יש, ושהסוכן החדש מקבל את הפעולה הבאה הנכונה. זאת הוכחה לתהליך, לא הוכחה לכך שכל דבר יתבצע אוטומטית.
אם אתם מצלמים הדגמה לריל, השתמשו במסמך בדיקה ללא שמות לקוחות, כתובות אימייל, מפתחות או צילומי מערכת חיים. הצופה צריך לראות את הרעיון ואת התוצאה, לא את המידע הפנימי שלכם.
בדיקה לפני מסירה
- יש מסמך הנחיות מרכזי עם גבולות פעולה ברורים.
- NEXT_STEPS מתחיל בפעולה אחת שאפשר לבצע עכשיו.
- WORKLOG מציין מה הושלם ואיפה נמצאת התוצאה.
- קבצי המצב לא כוללים סודות, נתוני לקוחות או קישורים חתומים.
- ה־hook או תהליך הקריאה נבדקו עם נתוני דמה לפני שימוש על פרויקט חי.
- סוכן חדש מצליח להסביר מה הצעד הבא לפני שהוא משנה קובץ.
שאלות נפוצות
האם Claude ו־Codex חולקים את היסטוריית הצ׳אט שלי?
לא. השיטה שומרת מצב עבודה וכללים בקבצים מקומיים שהסוכן הבא יכול לקרוא. היא אינה מעבירה את הזיכרון הפנימי או את כל היסטוריית השיחה מכלי לכלי.
חייבים hook כדי לעבוד כך?
לא. אפשר להתחיל בקריאה ידנית של מסמך ההנחיות, NEXT_STEPS ו־WORKLOG. hook מקומי רק מקצר את הפעולה החוזרת, ולכן יש לבנות ולבדוק אותו לפי סביבת העבודה שלכם.
איפה שומרים את המפתחות והחיבורים?
מחוץ לקבצי ההנחיות ובמנגנון הסודות המתאים לסביבה שלכם. קובצי handoff יכולים לציין שיש חיבור זמין, בלי להעתיק אליו את הערך הסודי.
האם זה מתאים גם לצוות אנושי?
כן. אותו מבנה עוזר גם לאדם שמצטרף למשימה: הוא רואה החלטות, תוצאה והמשך, במקום לחפש אותן בשרשור ארוך.
רוצים לבדוק איך התהליך מתאים לעסק שלכם?
שלחו לי את המילה ״זיכרון״ בוואטסאפ וכתבו איזה סרטון אתם רוצים להכין.