$ man how-to/how-to-build-persistent-ai-memory

כל סשן AI מתחיל עם אמנזיה. Claude Code נפתח, קורא את ה-CLAUDE.md שלך, ויודע את המוסכמות של הפרויקט. אבל הוא לא יודע מה עבדת עליו אתמול, אילו החלטות התקבלו, מה חסום, או מה הצעד הבא. אתה מסביר את ההקשר מחדש כל סשן. זה מבזבז זמן וטוקנים. הפתרון הוא מערכת זיכרון - מסמכים מובנים שנושאים מצב בין סשנים. לא dump של היסטוריית צ'אט. לא סיכום מעורפל. מערכת שנותנת לכל סשן חדש בדיוק את ההקשר שהוא צריך כדי להמשיך מאיפה שהקודם הפסיק.

PATTERN

למערכת זיכרון AI ברמת production יש שלוש שכבות. כל אחת משרתת מטרה אחרת ונשמרת באופן שונה. שכבה 1: העברות סשן (זיכרון אפיזודי). מה קרה בסשן האחרון. מה נבנה, אילו החלטות התקבלו, מה המצב הנוכחי, מה צריך לקרות הלאה. נכתב בסוף כל סשן. נקרא בתחילת הבא. קצר-חיים - ההעברה של אתמול חשובה, של שבוע שעבר לא. שכבה 2: זיכרון אוטומטי (זיכרון סמנטי). עובדות יציבות על הפרויקט והמשתמש. העדפות, מוסכמות, החלטות ארכיטקטוניות מרכזיות, נתיבי קבצים חשובים. נשמר ללא הגבלת זמן. מתעדכן כשעובדות חדשות מאושרות במספר סשנים. זהו קובץ ה-MEMORY.md ש-Claude Code מנהל בתיקיית הפרויקטים שלו. שכבה 3: בסיס ידע (זיכרון פרוצדורלי). איך לעשות דברים. כישורים, תהליכי עבודה, תבניות, דפוסים. ה-CLAUDE.md, קבצי skills, וערכי wiki. נשמר כל עוד הפרויקט קיים. מתפתח לאט דרך עדכונים מכוונים. שכבה 1 משתנה יומית. שכבה 2 משתנה שבועית. שכבה 3 משתנה חודשית. כל שכבה נטענת בזמן אחר ומשרתת פונקציה שונה בחלון ההקשר.

CODE

העברת סשן היא מסמך Markdown מובנה שנכתב בסוף כל סשן Claude Code. הוא עונה על חמש שאלות: 1. מה נעשה? - רשימת עבודה שהושלמה עם קבצים ספציפיים שהשתנו 2. מה המצב הנוכחי? - branch ב-Git, שינויים לא מחויבים, סטטוס בנייה 3. אילו החלטות התקבלו? - בחירות מרכזיות והנימוקים שלהן 4. מה חסום? - תלויות, המתנה לקלט חיצוני, שאלות פתוחות 5. מה צריך לקרות הלאה? - רשימה ממוינת לפי עדיפות של צעדים הבאים ההעברה נשמרת בקובץ עם חותמת זמן: ~/.claude/handoffs/YYYY-MM-DD_HHMMSS_slug.md. שמות עם חותמת זמן מונעים התנגשויות כשמספר סשנים רצים במקביל. בתחילת הסשן, Claude Code קורא את כל ההעברות שלא נצרכו (קבצים שלא מסתיימים ב-_done.md), מעבד אותם, ואז משנה את השם של כל אחד ל-file_done.md. העברות ישנות שנצרכו מנוקות אחרי 7 ימים. זה בטוח למקביליות. שני סשנים של Claude Code בטרמינלים שונים יכולים לכתוב העברות בלי לדרוס אחד את השני. הסשן הבא קורא את כולם ומקבל את ההקשר המשולב.

PATTERN

ל-Claude Code יש מערכת זיכרון אוטומטי מובנית. היא כותבת לקובץ MEMORY.md בתיקיית ההגדרות של הפרויקט. קובץ זה נטען להקשר בתחילת הסשן. כללים לזיכרון אוטומטי אפקטיבי: שמור דפוסים יציבים שאושרו במספר אינטראקציות. לא כל עובדה חד-פעמית - דפוסים שאתה רואה חוזרים. "המשתמש מעדיף הזחה של 2 רווחים" הוא יציב. "המשתמש עובד על מודול האימות היום" הוא ספציפי לסשן ושייך להעברה, לא לזיכרון. ארגן לפי נושא, לא לפי כרונולוגיה. צור קבצים נפרדים לתחומים שונים (debugging.md, infrastructure.md, voice-rules.md) וקשר אליהם מ-MEMORY.md. זה שומר על קובץ הזיכרון הראשי רזה. שמור את MEMORY.md מתחת ל-200 שורות. שורות אחרי 200 נחתכות כשנטענות להקשר. שים את העובדות הכי חשובות קודם. העבר פרטים לקבצי נושא. עדכן או הסר זיכרונות מיושנים. אם מוסכמה השתנתה, עדכן את הזיכרון. אם החלטה בוטלה, מחק את הזיכרון הישן. זיכרונות מיושנים גורמים יותר נזק מאשר בלי זיכרונות כי ה-AI עוקב אחר הוראות לא עדכניות בביטחון. שמור בקשות מפורשות של המשתמש מיד. אם המשתמש אומר "תמיד תשתמש ב-bun במקום npm," שמור את זה עכשיו. אל תחכה לאישורים מרובים.

PRO TIP

הנה איך שלוש השכבות עובדות יחד בתהליך עבודה יומי אמיתי. 9 בבוקר: פותח את Claude Code. הוא קורא את CLAUDE.md (שכבה 3 - מכיר את הפרויקט). הוא קורא את MEMORY.md (שכבה 2 - מכיר את ההעדפות שלי). הוא קורא את ההעברה של אתמול (שכבה 1 - יודע מה קרה אתמול). תוך 10 שניות, ל-Claude יש את ההקשר של חבר צוות שהיה כאן אתמול. במהלך הסשן: Claude משתמש בשכבה 3 כדי לעקוב אחר מוסכמות הפרויקט. הוא משתמש בשכבה 2 כדי להתאים להעדפות שלי. הוא משתמש בשכבה 1 כדי להמשיך את העבודה של הסשן הקודם בלי שאני מסביר שום דבר מחדש. סוף הסשן: Claude כותב העברה חדשה (שכבה 1). אם התגלו דפוסים יציבים, הוא מעדכן את MEMORY.md (שכבה 2). אם תהליך עבודה השתנה, ה-skill הרלוונטי מתעדכן (שכבה 3). אפקט ריבית דריבית: אחרי שבוע של זה, המערכת מכירה את הפרויקט שלי לעומק. אחרי חודש, היא מטפלת ב-80% מהעבודה השגרתית בלי שאני מספק הקשר. אחרי שלושה חודשים, סשן חדש של Claude פרודוקטיבי יותר בדקה הראשונה שלו ממפתח אנושי חדש ביום הראשון. התובנה המרכזית: זיכרון הוא לא קובץ בודד. הוא שלוש שכבות שמשרתות אופקי זמן שונים. בנה את שלושתן ואפקט הריבית דריבית דרמטי.