מוח שני ב-Claude Code: איך לבנות את המבנה בתוך שעה
Markdownאיך לבנות מוח שני עבור Claude Code: היררכיית זיכרון, מבנה תיקיות בן חמישה חלקים ו-git, כדי שהסוכן יזכור הכול על הפרויקט שלכם בין פגישות.
קריאת המאמר המלא
נקודה מרכזית
מוח שני ב-Claude Code אינו קובץ אחד; הוא מבנה של חמש תיקיות בתוספת git. CLAUDE.md מגדיר את הכללים ואת נתיבי ההפניה, business/ מאחסן ידע על הפרויקט, ai-clone/ מאחסן מידע עליכם כמקבלי החלטות, plans/ מכילה תוכניות טכניות, ו-retrospectives/ מכילה לקחים מפגישות קודמות. הסוכן מתחיל ב-CLAUDE.md ועוקב אחר הקישורים לתיקייה המתאימה לבקשה המסוימת. המאמר הזה עוסק בהיררכיית הזיכרון שבתיעוד הרשמי של Claude Code, במבנה בן חמישה חלקים ובדרך לבנות אותו צעד אחר צעד בתוך שעה.
תיעוד העזר של Ailoot: ailoot.ai/docs/.
למה Claude Code זקוק למוח שני, ומה חשוב בו?
נקודה מרכזית
קובץ CLAUDE.md אחד מכסה את הכללים הבסיסיים, אבל הוא לא יכול להכיל את כל הידע העסקי. אחרי חודש שכחתם למה העליתם את המחיר. אחרי שלושה חודשים שכחתם למה דחיתם תשלומים בתשלומים. הידע נמצא בו-זמנית בארבעה מקומות: בראש שלכם, בצ'אטים בטלגרם, במסמכי Google ובראשים של העובדים. מוח שני אוסף את הכול בתיקייה אחת של קובצי markdown לצד הפרויקט, ו-Claude יכול לגשת אליה בעצמו.
אתם פותחים את Claude Code ביום שלישי. אתם מסבירים: זה הפרויקט, זו הקהל, את זה אל תעשה. אתם עובדים יחד. ביום חמישי נפתח צ'אט חדש, ואתם צריכים להסביר הכול מחדש.
אם יש לכם CLAUDE.md, פתרתם את התסכול הראשוני. הכללים הבסיסיים ותיאור הפרויקט נמצאים בקובץ אחד ונטענים בכל פגישה. הסברתי איך הקובץ הזה עובד במדריך שלי ל-CLAUDE.md - אפשר לקרוא אותו קודם כדי לבסס את היסודות.
אבל CLAUDE.md הוא מדריך הוראות לעובד חדש. איך להתלבש, באיזה טון לדבר עם לקוחות, באילו פקודות להשתמש לפרסום. זה לא מספיק כדי לקבל החלטות טובות לגבי הפרויקט. החלטות דורשות ידע: מה המוצר, מי הקהל, איך הכלכלה עובדת, מה ניסיתם ומה לא עבד.
בניסיון המחבר המתואר כאן, הידע הזה היה בעבר בארבעה מקומות: בראש שלו, בצ'אטים בטלגרם, במסמכי Google ובראשים של העובדים. חודש אחרי החלטה, אף אחד לא זכר למה היא התקבלה. אדם חדש היה מבלה שעה בשאלות לצוות כדי להבין את העניינים. Claude כלל לא היה חלק מההקשר הזה.
לפני המוח השני, לפי הניסיון המתואר של המחבר, כל פגישה פירושה היה להסביר מחדש מי הלקוח, איך ההצעה בנויה ואיזה ספק מטפל בתשלומים. עם business/, אני פותח צ'אט ואומר: "עדכן את ההצעה לפי תוכנית התמחור החדשה" - Claude ניגש בעצמו ל-business/company/legal.md, קורא את הדרישות, ואז עובר ל-business/products/pricing.md, רואה את תוכנית התמחור החדשה ומציע עריכה בפעולה אחת. שלב ההיכרות נעלם; ההקשר נטען אוטומטית.
הערה
זו לא בעיה בזיכרון של Claude. זו בעיה של ארכיטקטורה. חלון ההקשר של סוכן הוא זיכרון העבודה שלו. הוא טוען רק את מה שאתם מפנים אליו במפורש. כל השאר נמצא מחוץ לחלון ונטען לפי דרישה. מוח שני מאחסן את "כל השאר" בצורה מובנית, כדי ש-Claude יוכל להתמצא בו.
Anthropic מכנה את הבעיה הזאת context rot בבלוג ההנדסה שלה:
ככל שיש יותר אסימונים בחלון ההקשר, כך המודל מתקשה יותר להיזכר במדויק במידע מתוך ההקשר הזה.
במילים אחרות, ככל שדוחסים יותר מידע לחלון, כך הסוכן מתקשה יותר לעבוד עם פרטים. הפתרון הוא לשמור מבנה של קבצים חיצוניים ש-Claude יכול לבקר בהם בעצמו בתגובה לבקשה מסוימת. זהו מוח שני.
מהו מוח שני, ואיך הוא מתאים ל-Claude?
נקודה מרכזית
הרעיון פשוט: המוח שלכם נועד לחשוב, לא לאחסן מחשבות. עבור Claude Code, מוח שני הופך משיטת פרודוקטיביות לארכיטקטורת סוכנים: תיקיית הערות חיצונית שהסוכן יכול לגשת אליה ישירות דרך מערכת הקבצים.
בדרך כלל, מוח שני משמש לפרודוקטיביות: אנשים יוצרים כספת Obsidian ומוסיפים קטעים מספרים, הערות משיחות ורעיונות לפרויקטים.
כשהמחבר יישם את הרעיון בעבודה עם Claude Code, הוא חדל לעסוק בפרודוקטיביות והפך לארכיטקטורת סוכנים.
בגישה הקלאסית, המוח השני שייך לכם ואתם ניגשים אליו ידנית. בעבודה עם Claude Code, המוח השני הופך לדו-כיווני: גם אתם וגם הסוכן ניגשים אליו. הדבר משנה את דרישות הפורמט שלו.
מכיוון שהסוכן ניגש אליו בעצמו, הקבצים צריכים להיות בפורמט שהוא מבין בלי אינטגרציה נפרדת. Markdown הוא אידיאלי: טקסט, היררכיית כותרות וקישורים בין קבצים. Notion ו-Google Docs אינם מתאימים. אפשר לחבר אותם דרך MCP, אבל הדבר מוסיף שכבה נוספת, אסימון נוסף לכל בקשה ונקודת כשל נוספת.
מכיוון שהקבצים נמצאים במערכת הקבצים לצד הפרויקט, הם נמצאים אוטומטית בהישג ידו של Claude Code. אין צורך בהגדרה. מפעילים את הסוכן בתיקיית הפרויקט והוא יכול לראות את כל הקבצים שבתוכה. זה בחינם ועובד מיד.
טיפ
אפשר לשמור את המוח השני ב-Obsidian - גם אני פותח אותו שם כדי שיהיה קל יותר לראות את גרף הקשרים. אבל הקבצים עצמם נמצאים בתיקייה רגילה לצד הקוד. Obsidian הוא רק מעטפת נוחה לקובצי markdown. Claude יכול לראות אותם גם בלי Obsidian. אפשר להשתמש בכל עורך; העיקר הוא שהקבצים יהיו בדיסק ולא בשירות ענן עם פורמט משלו.
איזו היררכיית זיכרון יש ל-Claude Code כברירת מחדל?
נקודה מרכזית
Claude Code יכול לקרוא כברירת מחדל ארבע רמות של CLAUDE.md (ארגונית, משתמש, פרויקט ומקומית), ומגרסה 2.1.59 הוא מנהל זיכרון אוטומטי משלו ב-~/.claude/projects/<project>/memory/. זה מספיק לזיכרון בסיסי, אבל לא להקשר עסקי - אותו שמים בתיקייה נפרדת לצד הפרויקט.
לפני שמוסיפים משהו משלכם, נבחן מה Claude יכול לזכור בלי עזרתכם. Anthropic מתארת שני מנגנונים בתיעוד הרשמי: CLAUDE.md (כללים שאתם כותבים) וזיכרון אוטומטי (לקחים ש-Claude כותב בעצמו). שניהם נטענים בתחילת כל פגישה.
Claude מחפש קובצי CLAUDE.md בארבעה מקומות בו-זמנית:
| רמה | מיקום | מטרה |
|---|---|---|
| ארגונית | /Library/Application Support/ClaudeCode/CLAUDE.md (macOS), /etc/claude-code/CLAUDE.md (Linux), C:\Program Files\ClaudeCode\CLAUDE.md (Windows) | כללים שמנהל פורס לכל הצוות דרך MDM. אנשים פרטיים לא זקוקים לזה. |
| משתמש | ~/.claude/CLAUDE.md | כללים אישיים שחלים בכל הפרויקטים. "ענה בשפה המועדפת עליי", "אל תשתמש במקפים ארוכים". |
| פרויקט | ./CLAUDE.md בשורש הפרויקט | כללים לפרויקט מסוים: מחסנית טכנולוגית, מבנה תיקיות, כללים עסקיים. נשמר ב-git. |
| מקומית | ./CLAUDE.local.md | הערות אישיות שלכם לפרויקט הזה, שאינן נשמרות ב-git. בתוך .gitignore. |
כל ארבעת הקבצים נטענים להקשר. ככל שהרמה ספציפית יותר, כך העדיפות שלה גבוהה יותר. הקובץ המקומי נקרא אחרון, ולכן הכללים שלו גוברים על כל השאר.
קובץ CLAUDE.md יכול להימצא גם בכל תיקייה בתוך הפרויקט. כש-Claude קורא קובץ מתיקיית משנה, הוא טוען לפי דרישה את CLAUDE.md של אותה תיקייה. הדבר שימושי במונוריפו: כללי frontend נמצאים ב-frontend/CLAUDE.md, כללי backend ב-backend/CLAUDE.md, והם נטענים רק כשהסוכן עובד בחלק הרלוונטי.
הזיכרון האוטומטי הופיע ב-Claude Code 2.1.59. אלה קבצים ש-Claude כותב עליכם:
~/.claude/projects/<project-name>/memory/
├── MEMORY.md # אינדקס, נטען בכל פגישה (200 שורות או 25KB)
├── debugging.md # הערות מפורטות (נטענות לפי דרישה)
├── api-conventions.md
└── ...
Anthropic מתארת זאת כך בתיעוד הרשמי:
Claude לא שומר משהו בכל פגישה. הוא מחליט מה כדאי לזכור לפי השאלה אם המידע עשוי להיות שימושי בשיחה עתידית.
הזיכרון האוטומטי מופעל באמצעות הדגל autoMemoryEnabled בקובץ ~/.claude/settings.json. Claude מחליט מה לכתוב שם. אפשר לקרוא את MEMORY.md ולערוך אותו ידנית - זהו markdown רגיל.
אזהרה
זיכרון אוטומטי שימושי, אבל הוא אינו תחליף למוח שני. Claude כותב בו תובנות מעשיות על כלים ודפוסי קוד. "הסקריפט הזה נכשל בלי הדגל X", "שם הטבלה במסד הנתונים הוא זה". הוא לא כותב שם אסטרטגיה עסקית. אם אתם רוצים שהסוכן יזכור מי הקהל שלכם ולמה בחרתם מחיר מסוים, עליכם להוסיף זאת בעצמכם לתיקיית הקשר נפרדת.
CLAUDE.md או מוח שני - איפה צריך למתוח את הגבול?
נקודה מרכזית
CLAUDE.md הוא מדריך הוראות לעובד חדש: איך להתנהג, באילו פקודות להשתמש ומה לא לעשות. מוח שני הוא ויקי של החברה: מה אתם עושים, למי זה מיועד, איך הכלכלה עובדת ומה ניסיתם. קובץ אחד של כללי התנהגות לצד מבנה של ידע חיצוני. CLAUDE.md הוא האינדקס; המוח השני הוא הארכיון. בלי האינדקס, הסוכן לא יודע שהארכיון קיים. בלי הארכיון, הוא מכיר רק את הכללים ולא את ההקשר העסקי.
הנה האנלוגיה שאני משתמש בה בהרצאות: דמיינו ששכרתם עובד חדש. מה נותנים לו ביום הראשון?
מדריך הוראות: איך להתלבש, מתי להגיע, באיזה טון לדבר עם לקוחות ובאיזו מערכת לפרסם. זהו מסמך קצר. הוא לא מסביר מה אתם עושים ולמה. הוא פשוט אומר איך להתנהג.
בנפרד, נותנים לו גישה לוויקי של החברה. הוא מסביר מה המוצר, למי הוא מיועד, מיהו הקהל, מה המחיר ולמה, מי המתחרים ואילו טעויות עשיתם. זהו ארכיון נרחב. אף אחד לא קורא את כולו - נכנסים אליו כדי למצוא תשובה לשאלה מסוימת.
CLAUDE.md = מדריך הוראות. מוח שני = ויקי. אתם צריכים את שניהם.
ההבחנה פשוטה. שימו ב-CLAUDE.md את כל מה שרלוונטי לכל משימה:
- מי הסוכן בפרויקט הזה (עוזר, מוביל, מסייע)
- באיזו שפה לענות
- מחסנית הכלים
- פקודות פרסום
- איסורים (לא להשתמש במקפים ארוכים, לא להריץ
git push --force) - ניתוב: לאן לפנות להקשר עסקי ולאן לפנות לעקרונות
שימו במוח השני את כל מה שנחוץ לפי דרישה:
- המוצר, הקהל, הכלכלה והיעדים
- מתחרים ושוק
- החלטות קודמות והסיבות להן
- דוגמאות לקוחות וביקורות
- עקרונות ומתודולוגיה
Anthropic מציגה את אותה הבחנה בתיעוד שלה:
CLAUDE.md נטען בכל פגישה, לכן יש לכלול בו רק דברים שחלים באופן רחב. לידע תחומי או לתהליכי עבודה שנחוצים רק לפעמים, השתמשו בכישורים. Claude טוען אותם לפי דרישה בלי לנפח כל שיחה.
Skills הן דרך אחת לאחסן ידע אפיזודי. תיקיית business/ לצד הפרויקט היא דרך נוספת. אני משתמש בשתיהן, ואסביר עליהן בפירוט בהמשך.
ממה מורכב מוח פרויקט - 5 חלקים ומכונת זמן
נקודה מרכזית
מוח פרויקט מורכב מחמש תיקיות עם git מעליהן. CLAUDE.md מגדיר כללים וניתוב. ai-clone/ מאחסן את ההיטל הדיגיטלי שלכם: העקרונות, הטון והמשוב שלכם אחרי טעויות. business/ מאחסן ידע על הפרויקט. plans/ מכילה תוכניות טכניות לפי שלב. retrospectives/ מכילה מחשבות מסכמות אחרי פגישות. Git הופך את הכול למכונת זמן: כעבור שנה אפשר לפתוח כל קובץ ולראות מה היה בו כשהתקבלה החלטה.
דוגמה לארכיטקטורה מתוך הניסיון המתואר של המחבר:
| תיקייה | מה יש בפנים | מטרה |
|---|---|---|
CLAUDE.md | כללי פרויקט, מחסנית טכנולוגית, מבנה קבצים, ניתוב תיקיות, שפת תקשורת | זהו מדריך ההוראות של הסוכן. נטען בכל פגישה. פחות מ-200 שורות, ועדיף 80-120. |
ai-clone/ | מי אני, העקרונות שלי, הטון שלי, סגנון קבלת ההחלטות שלי, משוב אחרי טעויות | היטל דיגיטלי שלי כמקבל החלטות. הוא יודע מה אדחה מיד, באיזה סגנון אני מציע דברים ואת הכללים שלמדתי מטעויות. |
business/ | מוצר, קהל, יעדים, כלכלה, שיווק, החלטות קודמות, דוגמאות | קובצי markdown מקושרים עם קישורי ויקי. כל קובץ מתחבר לאחרים דרך קישורי [[...]]. הסוכן ניגש לשם כדי לענות על שאלה מסוימת. |
plans/ | תוכנית אחת לכל תכונה. קובץ YYYY-MM-DD-feature.md עם שלבים ותיבות סימון | Plan Mode קיים בשיחה אחת ונעלם אחרי /clear. תיקיית plans/ נמצאת במאגר - כל סוכן יכול להמשיך את התוכנית בכל עת. |
retrospectives/ | מחשבות מסכמות אחרי כל פגישה: מה נעשה, מה לזכור ומה אפשר לשפר | למידה עצמית של המערכת. טעויות הופכות לכללים ב-ai-clone/feedback/. |
+ git | היסטוריית גרסאות של כל הקבצים | מכונת זמן. פותחים כל קובץ ומריצים git log כדי לראות מתי השתנה ולמה. |
הנקודה המתודולוגית המרכזית היא להפריד בין ai-clone/ ל-business/.
business/ עונה על השאלה "מה אנחנו עושים?" מוצר, קהל, מחירים, מתחרים. היא עוסקת בפרויקט. אם תעבירו את הפרויקט לשותף מחר, התיקייה הזאת תעבור איתו.
ai-clone/ עונה על השאלה "איך אני מקבל החלטות?" העקרונות, הטון, המלאכה והמילים שאסור להשתמש בהן. היא עוסקת בי. אם אתחיל פרויקט חדש מחר, התיקייה הזאת תעבור איתי.
מה צריך להיכנס ל-business/, ומה לא?
נקודה מרכזית
שימו ב-business/ עובדות על הפרויקט שמשתנות פעם בשבוע או פחות: מיצוב, קהל, מוצרים ומחירים, יעדים רבעוניים והחלטות מרכזיות. השאירו בחוץ תכתובות צ'אט, חומרי גלם לא מעובדים, מידע שכבר מופיע בקוד, צילומי מסך ומספרים דינמיים. החליפו מספרים בסמן LIVE ובקישור לשאילתת SQL - אסביר על כך בחלק נפרד בהמשך.
מבנה business/ ברמה העליונה בפרויקט המתואר של המחבר:
business/
├── INDEX.md ← מפת התיקייה, קוראים תחילה
├── company/ ← ייעוד, ישות משפטית, ערכים, מדיניות משפטית
├── products/ ← מוצרים, תוכניות, מחירים
├── audience/ ← פרופיל לקוח, פלחים, התנגדויות
├── goals/ ← יעדים שנתיים, רבעוניים וחודשיים, מדדים
├── economics/ ← כלכלת יחידה, הכנסות, הוצאות, תחזית
├── marketing/ ← ערוצים, משפך, חומרים, מתחרים
├── execution/ ← תכנון שבועי, backlog
└── assets/ ← מערכת עיצוב, ביקורות, מאגר טקסטים
זו דוגמה מתוך הפרויקט המתואר של המחבר, לא חוק מחייב. אני יוצר תיקיות לפי הצורך. התחלתי בשלוש (products/, audience/, goals/); האחרות נוספו אחרי 2-3 חודשים, כשהיה לא ברור היכן לשים דברים חדשים.
הקובץ הראשי בתיקייה הוא INDEX.md. זו מפה. הוא מכיל טבלה של "שאלה → קובץ" שבה Claude משתמש כדי להבין לאן לפנות. בלעדיה, הסוכן מבזבז אסימונים בקריאת כל הקבצים לפי הסדר.
קטע לדוגמה מתוך INDEX.md:
### היכן למצוא דברים
| מה צריך | היכן לחפש |
|---|---|
| מי הלקוח שלנו ומהן נקודות הכאב שלו | `business/audience/avatar.md` |
| מוצרים, תוכניות ומחירים | `business/products/` |
| יעדים ומדדים | `business/goals/` |
| כלכלה (הכנסות, הוצאות, כלכלת יחידה) | `business/economics/` |
| ערוצי קידום וחומרים | `business/marketing/` |
אחר כך מספיקה שורה אחת ב-CLAUDE.md: "לשאלות עסקיות, קרא את business/INDEX.md ופעל לפי המפה." הסוכן לא טוען את כל התיקייה להקשר. הוא טוען את המפה, בוחר את הקובץ המתאים וקורא רק אותו.
רשימת דברים שלא להכניס ל-business/:
- תכתובות צ'אט גולמיות בלי עיבוד. אם יש תובנה, תמצתו אותה וכתבו אותה. אם אין, השאירו אותה בחוץ.
- מידע שכבר מופיע בקוד. אין צורך ב"התשלומים עוברים דרך CloudPayments"; הסוכן יכול לראות זאת בקוד.
- צילומי מסך ותמונות. הם מגדילים את נפח התיקייה ואינם מפוענחים על ידי מודל טקסט ללא שלב נוסף.
- מספרים דינמיים. "היום יש 423 תשלומים עבור המוצר" כבר לא יהיה מעודכן בעוד שבוע. השתמשו בסמן LIVE ובקישור לשאילתת מסד נתונים.
- מידע רגיש או מפוקפק. אם המאגר היה מתפרסם מחר ב-YouTube לעיני 100 אלף זרים, השאירו רק מה שהייתם מוכנים להציג. עובדים, סוכנים ולעיתים גם קבלנים חיצוניים קוראים את התיקייה.
אזהרה
אם המאגר ציבורי, גם תיקיית business/ ציבורית. אני מתייחס למוח השני כאילו המאגר עלול להפוך לציבורי מחר, גם אם הוא פרטי כרגע. בלי שמות לקוחות ללא הסכמה, בלי נתוני הכנסה חודשיים ובלי סיסמאות. ההרגל הזה חוסך הרבה לחץ.
למה להחזיק תיקיית ai-clone נפרדת, ולמה לא לערבב אותה עם business?
נקודה מרכזית
ai-clone/ מאחסן את ההיטל הדיגיטלי שלכם: עקרונות, טון, מילים שאסור להשתמש בהן ומשוב אחרי טעויות. כל טעות של סוכן הופכת לכלל ב-ai-clone/feedback/ לפי הנוסחה "כלל → למה → איך ליישם". התיקייה עוברת איתכם מפרויקט לפרויקט. business/ נשארת עם הפרויקט. שמרו אותן בנפרד: בפרויקט חדש, business/ תהיה חדשה, אבל העקרונות והסגנון שלכם יישארו זהים.
הרעיון פשוט: העסק יודע מה אנחנו עושים. ה-clone יודע איך אני מקבל החלטות.
מבנה ai-clone/ בפרויקט המתואר של המחבר:
ai-clone/
├── INDEX.md ← מפת תיקייה
├── role.md ← מי אני, רקע, מה חשוב לי
├── identity/ ← ערכים, חזון, ייעוד
├── thinking/ ← מודלים מנטליים מתוך הרצאות
├── voice/ ← טון, אוצר מילים, סגנון
├── principles/ ← אמונות לגבי מוצר, קוד ועסקים
├── feedback/ ← כללים שנלמדו מטעויות ← התיקייה המרכזית
├── style/ ← מילים שאסור להשתמש בהן, פורמט Telegram
└── reference/ ← כלים, סביבה
התיקייה השימושית ביותר היא feedback/. היא מכילה כללים ספציפיים שלמדתי מטעויות של סוכנים. כל כלל נשמר בקובץ נפרד בפורמט הזה:
---
name: short-name
description: שורה אחת - מה נמצא בקובץ ומתי להחיל זאת
type: feedback
---
כלל קצר במשפט אחד.
**למה:** למה הכלל קיים. הקשר, אירוע, תצפית.
**איך ליישם:** תנאים ספציפיים שבהם הכלל חל.
בלי "למה", הכלל מת - הסוכן לא יחיל אותו על מצב דומה. בלי "איך ליישם", לא ברור מתי להשתמש בכלל.
דוגמה מהתיקייה שלי: הכלל "מקף, לא מקף ארוך". הוא נוצר משום שהמקף הארוך — הוא סימן חזותי מרכזי לטקסט שנוצר על ידי בינה מלאכותית. הוא חל על כל טקסט שמיועד לפרסום. הקובץ נמצא ב-ai-clone/feedback/no-em-dashes.md.
אני עושה זאת קצת אחרת: אני כותב כללים ב-ai-clone/feedback/, ולא ב-CLAUDE.md. CLAUDE.md הוא קובץ של הפרויקט, אבל כללים לגבי טון וסגנון הם אישיים. הם עוברים איתי לפרויקט הבא. CLAUDE.md נשאר עם הפרויקט.
הערה
מדד לבשלות של הגישה הזאת: כמה פעמים בשבוע אתם אומרים לסוכן "לא, לא ככה" לגבי אותו דבר? במערכת בשלה, התשובה היא אפס. כל טעות הופכת לכלל ב-feedback/, והסוכן לא חוזר עליה בפעם הבאה.
מה הם Live Metrics, ולמה לא לקבע מספרים בקבצים?
נקודה מרכזית
מספרים בקובצי מוח שני מתיישנים בתוך ימים. "1,000 לקוחות" היום יהפכו ל-1,050 מחר ול-2,000 בעוד חודש. אם מקבעים את המספר בקובץ, כעבור חודש הסוכן יציע דברים על סמך נתונים מאתמול. הפתרון הוא סמן LIVE בקובץ ומסמך live-metrics.md נפרד עם שאילתות SQL מוכנות להרצה. כשהסוכן רואה LIVE, הוא ניגש למסד הנתונים, שולף את המספר העדכני ומסיק מסקנות על סמך נתונים עדכניים.
אחת המלכודות העיקריות בתחילת העבודה עם מוח שני היא מילויו במספרים לא מעודכנים. כותבים "יש לנו 320 לקוחות", וכעבור שבועיים כבר יש 410. כותבים "ההכנסה החודשית היא 4.7 מיליון", וכעבור חודש המספר כבר חסר הקשר: האם מדובר ביעד, בתוצאה בפועל או בתחזית?
בדוגמה של המחבר, זה עובד כך. בקובץ business/products/practicum.md מופיע סמן במקום מספר:
## מחזורים
> **LIVE** - הריצו את השאילתות ב-`live-metrics.md`, בסעיף "מכירות"
> כדי לראות את התשלומים העדכניים לפי מחזור.
| מחזור | תאריכים | משלמים |
|-------|------|------------|
| 1 | 10-12 במרץ, 2026 | LIVE |
| 2 | 24-26 במרץ, 2026 | LIVE |
קובץ נפרד בשם live-metrics.md מכיל שאילתות SQL מוכנות להרצה ותיאור של מה שהן מחזירות:
## מכירות (תשלומים לפי מחזור)
```sql
SELECT c.name, COUNT(p.id) AS paid, SUM(p.amount) AS revenue
FROM purchases p
JOIN cohorts c ON c.id = p.cohort_id
WHERE p.status = 'paid'
GROUP BY c.name
ORDER BY c.starts_at DESC;
```
כשאני שואל את הסוכן, "כמה תשלומים יש לנו עבור המחזור השני?", הוא:
- קורא את
business/products/practicum.md - רואה את סמן LIVE לצד המספר
- פותח את
live-metrics.md - מוצא את הסעיף "מכירות"
- מריץ את השאילתה מול מסד הנתונים של סביבת הייצור
- עונה לפי נתונים עדכניים
כך נפתרות שתי בעיות בבת אחת. המספרים לא מתיישנים, וההחלטות מתקבלות על סמך המצב הנוכחי ולא על סמך השנה שעברה.
אזהרה
בגישה המתוארת של המחבר, רק סוכנים מהימנים מקבלים גישה למסד הנתונים של סביבת הייצור. הם מקבלים את הגישה רק דרך מעטפת שמתעדת שאילתות ואינה חושפת סיסמאות. הצבת פקודת psql ישירה עם סיסמה גלויה בטקסט פשוט בתוך live-metrics.md היא רעיון גרוע. צרו מעטפת שמקבלת את הסיסמה ממשתנה סביבה ואינה חושפת אותה בפלט. זו שכבה טכנית נפרדת, אבל בלעדיה LIVE הופך לפרצת אבטחה.
איך AI מתמצא במוח השני עבור בקשה יחידה?
נקודה מרכזית
מסלול הבקשה תמיד זהה: Claude קורא את CLAUDE.md, רואה את המפות (business/INDEX.md, ai-clone/INDEX.md), ניגש לאינדקס הרלוונטי, עוקב אחריו לקובץ מסוים, ואם צריך, שולף מספר דרך LIVE. מדובר ב-5-6 פעולות קריאה במקום לדחוס את כל התיקייה להקשר. החלון נשאר פנוי להסקת מסקנות, ואסימונים אינם מתבזבזים על קבצים לא רלוונטיים.
בקשה מסוימת, למשל: "נסח הודעת אימייל למשתתפים על המחזור החדש".
- Claude מתחיל בחלון ריק. הוא טוען את CLAUDE.md (כללים, מחסנית טכנולוגית, ניתוב).
- מהניתוב ב-CLAUDE.md הוא רואה: "
ai-clone/INDEX.md- לקרוא תמיד בתחילת פגישה". הוא פותח את הקובץ ולומד מי אני, מה הטון שלי ובאילו מילים אסור לי להשתמש. - הוא רואה בניתוב: "תבניות אימייל -
src/lib/email/layout.ts". הוא פותח את הקובץ ומבין את הפורמט. - הוא רואה: "הקשר למוצר -
business/products/practicum.md". הוא פותח את הקובץ וקורא על המוצר. - הוא רואה את סמן LIVE בקובץ ואת ההפניה ל-
live-metrics.md. הוא פותח את הקובץ ומוצא את ה-SQL המוכן להרצה. אם נחוץ לו מספר עדכני, הוא מריץ את השאילתה. אם לא, הוא מסמן "לשלוף את המספר בזמן השליחה". - הוא רואה את כללי הטון ב-
ai-clone/style/telegram-format.md, את האיסור על מקפים ארוכים ב-ai-clone/feedback/no-em-dashes.mdואת שיעורי ההמרה של המשפך ב-business/marketing/funnel.md.
הוא כותב את האימייל בטון שלי, עם מספרים עדכניים וללא מקפים ארוכים או סמני בינה מלאכותית.
Anthropic מכנה את הגישה הזאת just-in-time context בבלוג ההנדסה שלה:
סוכנים שנבנו בגישת 'just in time' מחזיקים מזהים קלים (נתיבי קבצים, שאילתות שמורות, קישורים וכו') ומשתמשים בקישורים האלה כדי למשוך נתונים באופן דינמי להקשר בזמן ריצה, באמצעות כלים.
במילים אחרות, Claude נושא מצביעים לנתונים, לא את הנתונים עצמם. הדבר יעיל הרבה יותר מבחינת אסימונים וגם מדויק הרבה יותר, כי רק מידע רלוונטי מגיע להקשר. החלון נשאר פנוי להסקת מסקנות.
5 דפוסים שכדאי להימנע מהם במוח שני
נקודה מרכזית
הטעויות העיקריות של מתחילים עם מוח שני: 1) קובץ CLAUDE.md שהתנפח ליותר מ-500 שורות במקום נתב קצר; 2) תיקיית אחסון לכל דבר שהופכת למזבלה; 3) שכפול של דברים ש-Claude כבר יודע מהשפה או מהקוד; 4) קיבוע מספרים שמתיישנים בלי LIVE; 5) השארת ההקשר ללא גישה לסוכן או ללא ניתוב אליו, בין שהוא באותו מאגר ובין שהוא באחסון פרטי נפרד.
דפוס בעייתי 1. CLAUDE.md שהתנפח. 500 שורות הוראות "במקום לשים הכול במקום אחד". Anthropic אומרת זאת בבירור:
שמרו על קצר. עבור כל שורה, שאלו: 'אם אסיר אותה, האם Claude יתחיל לעשות טעויות?' אם לא, מחקו אותה. קובצי CLAUDE.md מנופחים גורמים ל-Claude להתעלם מההוראות החשובות שלכם!
אורך היעד הוא 80-120 שורות. שימו את כל השאר בקבצים נפרדים והפנו אליהם.
דפוס בעייתי 2. תיקייה לכל דבר. אתם זורקים למוח השני הכול: תכתובות צ'אט גולמיות, צילומי מסך חסרי תועלת, דוחות שאף אחד לא יקרא. כעבור חודש התיקייה תפחה, הסוכן מבזבז אסימונים על קריאת שטויות ואתם לא זוכרים איפה שום דבר נמצא. הכלל: כל קובץ במוח השני צריך לענות על שאלה מסוימת. אם אף אחד לא פתח אותו במשך שישה חודשים, מחקו אותו או העבירו אותו לארכיון.
דפוס בעייתי 3. כפילויות. "התשלומים עוברים דרך CloudPayments, ב-src/lib/payment/cloudpayments.ts; הספק מוגדר ב-.env." הסוכן יכול לראות את כל זה בקוד. אל תשכפלו את זה ב-business/. כפילויות מתיישנות: הקוד משתנה, business/ לא מתעדכנת והסוכן פועל על סמך מידע מיושן.
דפוס בעייתי 4. מספרים מקובעים. "יש לנו 1,247 לקוחות, עם שיעור המרה של 6.3%" - דמיינו שמדובר במספרים מאיזו חברת פינטק מופשטת. כל המספרים האלה יתיישנו בתוך שבוע. השתמשו בסמן LIVE וב-live-metrics.md. הסעיף בנושא מופיע למעלה.
דפוס בעייתי 5. הקשר ללא נתיב גישה זמין. אם המוח השני נמצא במקום אחר ולסוכן אין הרשאה או הפניה אליו, הפעלה מתיקיית הקוד אינה מספיקה. להערות משותפות שאינן רגישות, שמירת business/ ו-ai-clone/ בתוך המאגר היא מבנה נוח. להקשר פרטי, שמרו אותו במיקום עם בקרה נפרדת והגדירו במפורש גישה מותרת וניתוב. נוחות התיקיות אינה גוברת על סודיות.
טיפ
ענף נפרד (context או business-context) מארגן עבודה אך אינו גבול גישה: הקבצים שלו עדיין אובייקטי Git באותו מאגר ועלולים להתפרסם עם ענפים או היסטוריה. להקשר עסקי פרטי, השתמשו במאגר פרטי נפרד או באחסון חיצוני עם בקרות גישה מפורשות וניתוב מותר לסוכן. Submodule יכול להפנות למאגר פרטי נפרד, אך הפרטיות נובעת מהרשאות אותו מאגר ולא מה-submodule עצמו. אפשרות נוספת היא תיקייה מקומית שמוחרגת במכוון ויש לה גיבוי משלה; החרגת נתיב אינה מסירה קבצים שכבר במעקב Git או היסטוריה שכבר פורסמה. שמרו עם הקוד רק הקשר שמותר לשתף.
איך לבנות מוח שני בתוך שעה - מדריך צעד אחר צעד
נקודה מרכזית
אפשר להגדיר מוח שני מינימלי בתוך שעה: ליצור את תיקיות השורש business/ ו-ai-clone/, להכין בכל אחת מהן מפת INDEX.md, להוסיף תיאור מוצר קצר תחת business/products/, תיאור לקוח תחת audience/ ותיאור של מי אתם בתוך ai-clone/role.md. הוסיפו ב-CLAUDE.md ניתוב לתיקיות האלה. לאחר מכן הרחיבו אותו תוך כדי עבודה: אחרי כל טעות של סוכן, הוסיפו כלל ב-ai-clone/feedback/; אחרי כל החלטה, הוסיפו הערה ב-business/.
צרו שתי תיקיות בשורש
בשורש הפרויקט, לצד
src/:mkdir -p business/{products,audience,goals,economics,marketing} mkdir -p ai-clone/{identity,voice,principles,feedback,style}הכינו INDEX.md כמפת תיקייה
business/INDEX.mdהיא טבלה של "שאלה → קובץ". התחילו עם 5 שורות לפחות והוסיפו עוד ככל שמתקדמים. עשו אותו דבר ב-ai-clone/INDEX.md.הוסיפו תיאורים קצרים של המוצר והלקוח
business/products/main.md- מהו המוצר, למי הוא מיועד, כמה הוא עולה ומה מבדיל אותו. 30-50 שורות.business/audience/avatar.md- מי הלקוח, מהן נקודות הכאב שלו ומה הוא קונה. 30-50 שורות. אל תתארו לקוח אידיאלי - תארו לקוח אמיתי. אם אינכם יודעים משהו, סמנו "לברר" והמשיכו.תארו את עצמכם ב-ai-clone/role.md
מי אתם, מה אתם עושים ומה חשוב לכם. 20-30 שורות. זה מספיק כדי להתחיל. הוסיפו טון, עקרונות ומילים שאסור להשתמש בהן כשתבחינו שהסוכן כותב בסגנון שאינו שלכם.
הוסיפו ניתוב ל-CLAUDE.md
פתחו את
CLAUDE.mdוהוסיפו סעיף:## מפת הפרויקט - הקשר עסקי → `business/INDEX.md` - הקשר עליי → `ai-clone/INDEX.md` - תוכניות טכניות → `plans/YYYY-MM-DD-*.md` - מחשבות מסכמות מפגישות קודמות → `retrospectives/` קראו תמיד את `ai-clone/INDEX.md` ואת `business/INDEX.md` בתחילת פגישה.הפעילו את Claude Code ובדקו
פתחו את הסוכן. שאלו: "ספר לי על המוצר שלי ועל הקהל שלי." אם הוא עונה מתוך הקשר התיקייה, זה עובד. אם הוא ממציא דברים, בדקו שהתיקיות נמצאות לצד הפרויקט, ששמות הקבצים נכונים ושהניתוב ב-
CLAUDE.mdמנוסח במדויק.
לאחר מכן, המוח השני גדל לפי שני עקרונות.
ראשית: בכל פעם שהסוכן עושה טעות, הוסיפו כלל. אחרי 3-4 שבועות, יהיו ב-ai-clone/feedback/ 15-20 קובצי כללים, והסוכן יפסיק לעשות את רוב הטעויות הנפוצות.
שנית: בכל פעם שאתם מקבלים החלטה עסקית, תעדו אותה ב-business/. אם תעלו מחיר, הוסיפו הערה ל-business/products/pricing.md עם התאריך והסיבה. אם תשנו מיצוב, הוסיפו הערה ל-business/company/about.md. כעבור שישה חודשים יהיה לכם ארכיון שזוכר "למה".
הנחיה: הנחיה מוכנה לשימוש לעדכון מוח שני בערב
עבדנו יחד לא מעט השבוע.
נתח את כל השינויים בקוד מהשבוע, את כל ה-commits שעשינו.
איזה מידע בעל ערך מתוך זה צריך להיכלל ב-business/ - כתוב אותו בקבצים המתאימים
עם קישורי wiki לקבצים סמוכים, כדי שההקשר לא יאבד.
אם יש החלטות בקוד שלא הסברתי, שאל אותי למה
ותעד את הסיבה בקובץ המתאים, עם ציון התאריך.
אל תשכפל דברים שכבר ברורים מהקוד. כלול רק דברים שהסוכן
לא היה יודע בפגישה הבאה ללא business/.
מה הלאה - Skills, Subagents והנדסת הקשר
נקודה מרכזית
מוח שני בתוספת CLAUDE.md הם היסודות. מעליהם מוסיפים Skills (ידע תהליכי שנטען לפי דרישה, בהתאם לתיאור המשימה), Subagents (מופעי Claude מבודדים עם חלונות הקשר משלהם למשימות כבדות) והנדסת הקשר (ניהול התוכן שנכנס לחלון). אלה שלוש הקומות העליונות. הן לא עובדות בלי היסודות - אין לסוכן מה לקרוא.
אחרי שהמוח השני מוכן, יש עוד שלושה כלים ש-Anthropic מתארת כשלוש רמות שונות של מיטוב הקשר.
Skills הם ידע תהליכי. אם יש לכם תהליך עבודה שאתם חוזרים עליו (כתיבת מדריך לימוד, הכנת פוסט לטלגרם, ביקורת אתר), אפשר לקודד אותו בקובץ SKILL.md עם תיאור משימה. בתחילת פגישה, Claude סורק שמות ותיאורים של skills וטוען רק את אלה שמתאימים למשימה הנוכחית. כך נחסכים אסימונים ונשמר המיקוד.
Subagents הם מופעים מבודדים של Claude עם חלונות הקשר משלהם. הפעילו subagent למשימה תובענית (לקרוא 30 קבצים ולהכין סיכום), והוא עובד בחלון משלו ומחזיר רק את התוצאה. החלון הראשי נשאר פנוי. Anthropic כותבת:
תתי-סוכנים מתמחים יכולים לפתור משימות ממוקדות בחלונות הקשר נקיים. [...] כל subagent יכול לחקור בהרחבה, ולהשתמש בעשרות אלפי אסימונים או יותר, אך מחזיר רק סיכום דחוס ומזוקק של העבודה (לעיתים קרובות 1,000-2,000 אסימונים).
הנדסת הקשר היא ניהול התוכן שנכנס בכלל לחלון. חברת Anthropic כינתה אותה מיומנות יסוד בעבודה עם סוכנים ב-2025, רמה אחת מעל הנדסת prompt. הנדסת prompt היא בחירת הניסוח. הנדסת הקשר היא בחירת קבצים, נתיבים, skills ו-subagents.
מוח שני הוא אבן הבניין הראשונה של הנדסת הקשר. בלעדיו, Skills קוראים חלל ריק, ל-Subagents אין לאן לפנות וחלון הסוכן מתמלא במידע אקראי. איתו, שלושת הכלים מתחילים לעבוד.
הצעד הבא. צרו שתי תיקיות לצד הפרויקט: business/ ו-ai-clone/. הוסיפו לכל אחת INDEX.md עם 5 שורות שמשמשות כמפה. הוסיפו ארבע שורות ניתוב ל-CLAUDE.md. בתוך שעה יהיה לכם שלד עובד למוח שני. לאחר מכן הרחיבו אותו לפי הכלל "אחרי כל טעות של סוכן, הוסיפו שורה אחת ל-ai-clone/feedback/". הסברתי את התבנית המלאה של CLAUDE.md שתשמש אתכם לניתוב אל המוח השני במדריך איך להגדיר את CLAUDE.md בצורה נכונה.
מקורות
- תיעוד הזיכרון של Claude Code - היררכיית הזיכרון הרשמית של Claude Code מאת Anthropic
- Claude Code: שיטות עבודה מומלצות - הנחיות רשמיות לעבודה עם CLAUDE.md
- הנדסת הקשר יעילה עבור סוכני AI - Anthropic Engineering, הסבר על context rot, תקציב קשב והקשר just-in-time
- הסבר על Skills - בלוג Anthropic: ההבדלים בין Skills, זיכרון, Subagents ו-MCP
המשיכו לגלות את Ailoot ב-ailoot.ai.
פרטים נוספים
שאלות ותשובות: מוח שני ב-Claude Code: איך לבנות את המבנה בתוך שעה
האם הקשר עסקי בענף Git אחר נשאר פרטי?
לא. ענף הוא חלק מאותו מאגר וקבציו יכולים להיות משותפים עם אובייקטי המאגר וההיסטוריה. השתמשו באחסון פרטי עם בקרה נפרדת, או בתיקייה מקומית מוחרגת במכוון עם גיבוי; החרגת נתיב אינה מוחקת היסטוריה קיימת שבמעקב.
איך הסוכן אמור למצוא הקשר פרטי שמאוחסן מחוץ למאגר הקוד?
תנו לו הפניה מפורשת ורק את הרשאות הגישה שהמשימה דורשת. שמרו אינדקס קצר שמנתב למסמך הרלוונטי ואמתו שהסוכן יכול לקרוא את הקובץ המותר; מיקום פרטי ללא ניתוב אינו מספק הקשר אוטומטית.