$ man how-to/repo-context-engine

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

PATTERN

לכל תיקייה צריך להיות מטרה ברורה. לכל קובץ צריך להיות שם צפוי. כש-Claude צריך מחקר על שותף, הוא מחפש ב-partners/{name}/research/. כשהוא צריך כישור, הוא מחפש ב-.cursor/skills/{name}/SKILL.md. כשהוא צריך טיוטת תוכן, הוא מחפש ב-content/drafts/. השתמש בתחיליות תאריך לתוכן: 2026-02-18_topic-name.md. זה ממיין כרונולוגית ואומר ל-Claude מתי משהו נכתב. השתמש ב-slug באותיות קטנות לתיקיות: partners/acme/, skills/deploy/. השתמש ב-SKILL.md (אותיות גדולות) לקבצי כישורים כדי שיבלטו ברשימות תיקיות. הטקסונומיה היא לא עניין של אסתטיקה. היא עניין של צפיות. מבנה צפוי אומר ש-Claude מבזבז אפס זמן על חיפוש ואפס זמן על ניחוש נתיבי קבצים. הוא הולך ישר לקובץ שהוא צריך כי המבנה תמיד אותו דבר.

FORMULA

CLAUDE.md בשורש: ברירות מחדל של סביבה, העדפות שפה, סגנון קוד. מתחת ל-50 שורות. .cursor/skills/ או skills/: SKILL.md אחד לכל זרימת עבודה. Deploy, tracker, פרסום תוכן, הכשרת שותפים. .cursor/rules/: דפוסים ספציפיים לקבצים. חוקי עיצוב בלוג, מוסכמות TypeScript, אכיפת קול. content/: כל מה שאתה מייצר. טיוטות, פוסטים שפורסמו, תמונות, אינדקסים. partners/ או clients/: תיקיות לכל ישות עם מחקר, הנחיות, זרימות עבודה, משאבים. workflows/: אינדקסי תוכן, מעקב צינורות, לוחות שנה עריכתיים. data/: נכסים שנוצרו, סטטיסטיקות, ייצואים. בדרך כלל ב-gitignore לנתונים רגישים. scripts/: אוטומציה Python, עיבוד אצווה, טרנספורמציות נתונים. בדרך כלל ב-gitignore. זה לא המבנה התקף היחיד. אבל כל מבנה שתבחר, היה עקבי. מבנה אחד לכל שותף, לכל סוג תוכן, לכל זרימת עבודה. עקביות היא מה שגורם למנוע ההקשר לעבוד.

PRO TIP

ריפו הקשר מצטבר. כל קובץ שאתה מוסיף משפר סשנים עתידיים של AI. מדריך קול שכתבת בחודש הראשון גורם לכל פיסת תוכן מהחודש השני והלאה להישמע כמוך. תיקיית מחקר שותפים שיצרת ללקוח א' הופכת לתבנית ללקוחות ב' עד ת'. כישור שכתבת ל-deploy של אתר אחד מתפתח לכישור שעושה deploy לשלושה אתרים עם טיפול בשגיאות ואימות. הריפו שלי התחיל עם CLAUDE.md ושלושה כישורים. שישה חודשים אחר כך יש לו יותר מ-40 כישורים, מערכת קול מלאה, זרימות עבודה לשותפים, מערכת התקדמות RPG, ודשבורדים אוטומטיים. לא הפרשתי זמן לבניית מנוע ההקשר. בניתי אותו על ידי עשיית העבודה ותפיסת הדפוסים. כל יום הריפו משתפר. כל יום AI עובד איתו יותר טוב. זה האפקט המצטבר.