הסוכנים קוראים את הקוד שלכם ואת קבצי ההוראות של המאגר. הקשר מאחד את קבצי הזיכרון הללו יחד עם רשימות פרויקט, הקשר שנוצר והפניות.
כדי להבין את הרציונל מאחורי מה שנמצא כאן, קראו הקשר פרויקט בפרק מושגים. עמוד זה עוסק בניהולו.
קבצי זיכרון של המאגר
פתחו הגדרות → ידע → הקשר ולחפשו תחת מקורות מאגר. Coroid קורא קבצים אלה מהמאגר המחובר:
AGENTS.mdבשורש המאגר: הוראות כלליות לסוכניםCLAUDE.mdבשורש המאגר: הוראות ClaudeGEMINI.mdבשורש המאגר: הוראות Gemini.cursor/rules: קובץ הכללים של Cursor הנתמך
קבצים אלה נקראים לעיתים קרובות קבצי זיכרון. תוכנם המופעל משולב בהקשר הפרויקט של הסוכן לפני תחילת העבודה. השמות אינם מגבילים אותם למודל מסוים: מקורות המופעלים משולבים עבור סוכני Coroid.
קבצים קיימים מופיעים עם עריכה פעולה, ספירת טוקנים משוערת ומתג השולט על האם הסוכנים יקבלו אותם. מקורות מופעלים אלא אם תבטלו אותם במפורש. אם מספר קבצים חוזרים על עצמם או סותרים זה את זה, השאירו מופעלים רק את המקורות שאתם רוצים שיסעדו את הסוכנים ואת השאר בטלו.
יצירה מעידה על כך שהקובץ לא נמצא בבדיקת המאגר של Coroid. אם קריאה נכשלת, העמוד מציע ניסיון חוזר; כישלון גישה אינו מעיד על כך שהקובץ חסר. ודאו שהקובץ התקבע בענף של המאגר המחובר. עבור ביצוע משימה, הסוכן קורא את בדיקת המשימה, כך ששינויים בקבצי ההוראות באותו ענף יחולו על המשימה.
קבצי זיכרון מופעלים יכולים לייבא Markdown של המאגר באמצעות @path, לדוגמה
@AGENTS.md ב- CLAUDE.md או @docs/conventions.md. הנתיבים נפתרים יחסית לקובץ המכיל את ההפניה. Coroid עוקב אחר ייבואים מקוננים, עוצר מחזורים, וכולל כל קובץ וכל גוף הוראה זהה רק פעם אחת. ייבואים בתוך דוגמאות קוד וכתובות דוא״ל נשארים ללא שינוי. הפניות מחוץ למאגר אינן נטענות, וייבואים אינם יכולים לעקוף מקור מאגר שנבטל במפורש.
רק מקורות השורש המפורטים מזוהים אוטומטית. ייבואים מקוננים AGENTS.md וקבצי .cursor/rules/*.mdc בודדים יכולים להיכלל באמצעות ייבוא @ ; תחום התיקייה שלהם אינו נגזר אוטומטית.
הקשרי אפליקציות
תחת הקשרי אפליקציות, שמרו הוראות והפניות שנשמרו ב-Coroid. הערות ידניות והקשר פרויקט שנוצר יכולים להיות מופעלים או מנוטרלים באופן עצמאי מקבצי המאגר. השתמשו ברשומות אלה עבור מידע ששייך לחוץ ל-Git.
הוספת הקשר
בחרו הוספת הקשר ואף רשומה. לכל אחת יש כותרת ותוכן, וניתן לערוך או להסיר אותה מאוחר יותר.
רשומות טובות הן קצרות, ספציפיות ועמידות. החלטות ארכיטקטורה, כללי סגנון, חוזים של API, גבולות בעלות ואיסורים מפורשים – כולם שייכים לכאן. נרטיב הכניסה לצוות וכל דבר שברור כבר מהמאגר אינם רלוונטיים.
שמרו על רשומות נפרדות ובעלות שם
רשומה אחת לנושא, עם כותרת המתארת את תכולתה. "כללי טיפול בשגיאות" ו"מודולים קפואים" ניתנים לאיתור; רשומה אחת בשם "הערות" המכילה את שניהם אינה מתאימה.
דבר זה חשוב מכיוון שההקשר נטען באופן סלקטיבי בהתאם לעבודה הנוכחית – ראו מיומנויות מתפתחות. רשומות מנותקות היטב מאפשרות את הטעינה של הרשומה הנכונה עבור המשימה הרלוונטית.
הפניות
לצד רשומות כתובות ניתן לצרף קישורים ומסמכי התייחסות המצביעים על חומרים השמורים במקום אחר. השתמשו בהם כאשר העותק הרשמי נמצא בוויקי או בכלי עיצוב ואינכם רוצים עותק נוסף שייאבד מהעדכניות שלו.
הקשר לפי משימה
ההקשר של הפרויקט חל על כל מה שנמצא בתוכו. עבור חומרים הקשורים לחלק מסוים של העבודה – כגון כרטיס משימה, דוח לקוח או מסמך עיצוב – צרפו אותם לאותה משימה. הערה ספציפית למשימה שתישאר בהקשר של הפרויקט תהפוך לרעש בלתי רצוי בכל משימה עתידית.
שמירה על עדכניות
הקשר מיושן גרוע יותר מחוסר הקשר, מכיוון שהסוכנים מקבלים אותו כרשמי. כאשר יש שינוי בנוהג, עדכנו את הרשומה באותה פעולה שבה משתנה הקוד.
סקירת מה שקיים
קראו את ההקשר שלכם מדי פעם כאילו הייתם חדשים. רשומות נצברות, ואלו שנכתבו במהלך מעבר שנגמר לפני שנה הפכו כעת למטעות באופן פעיל.