הקשר הפרויקט

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

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

קבצי זיכרון של מאגר#

פתח הגדרות → ידע → הקשר וחפש תחת מקורות המאגר. Coroid קורא את הקבצים האלה מהמאגר המחובר:

• AGENTS.md בשורש המאגר: הוראות כלליות לסוכנים
• CLAUDE.md בשורש המאגר: הוראות Claude
• GEMINI.md בשורש המאגר: הוראות Gemini
• .cursor/rules: חוקי הפרויקט של Cursor, בין אם מתוך התיקייה של .mdc קבצי חוקים (כולל תת-תיקיות) או קובץ ישן אחד

לעיתים קרובות קוראים להם קובצי זיכרון. התוכן המופעל שלהם נכלל בהקשר הפרויקט של הסוכן לפני תחילת העבודה. השמות אינם מגבילים אותם למודל מסוים: מקורות מופעלים משולבים עבור הסוכנים של Coroid.

קבצים קיימים מוצגים עם ערוך פעולה, מספר משוער של טוקנים ומתג שקובע אם הסוכנים יקבלו אותם. מקורות מופעלים אלא אם תבטל אותם במפורש. אם מספר קבצים חוזרים על עצמם או סותרים זה את זה, השאר מופעלים רק את אלו שאתה רוצה שהסוכנים יפעלו לפיהם ובטל את האחרים.

שמירת עריכה בפרויקט עם מאגר מחובר מסוג GitHub או GitLab פותחת pull request עם השינוי, בענף חדש שמבוסס על ענף הבסיס של הפרויקט ב־pull request. Coroid אינו מבצע קומיט לענף ברירת המחדל, והסוכנים קוראים את הגרסה החדשה לאחר מיזוג ה־pull request. בפרויקט שהמאגר שלו מתארח ב־Coroid מתבצע קומיט במקום זאת. העורך מציין מה יקרה לפני השמירה.

Coroid קורא את כללי Cursor כפי ש־Cursor מחיל אותם:

קובץ רגיל .md ב־ .cursor/rules נדחה, מכיוון שCursor מתעלם ממנו. חוקים בתיקייה נערכים במאגר, כך שלשורה אין ערוך פעולה.

יצירה פירושו שאושר כי הקובץ חסר בעותק המאגר של Coroid. אם קריאה נכשלת, הדף מציע נסה שוב; כישלון גישה אינו מעיד על כך שהקובץ חסר. ודא שהקובץ מבוצע קומיט לענף של המאגר המחובר. עבור ביצוע משימה, הסוכן קורא את בדיקת המשימה, כך ששינויים בקבצי הוראות באותו ענף חלים על המשימה.

קבצי זיכרון מופעלים יכולים לייבא Markdown של מאגר עם @path, לדוגמה @AGENTS.md ב־ CLAUDE.md או @docs/conventions.md. הנתיבים נפתרים ביחס לקובץ שמכיל את ההפניה. Coroid עוקב אחר ייבואים מקוננים, עוצר מעגלי ייבוא, וכולל כל קובץ וכל גוף הוראה זהה פעם אחת בלבד. ייבואים בתוך דוגמאות קוד וכתובות דוא״ל נשארים ללא שינוי. הפניות מחוץ למאגר אינן נטענות, וייבואים אינם יכולים לעקוף מקור מאגר שהושבת במפורש.

רק המקורות המנויים מזוהים אוטומטית. AGENTS.md ניתן לכלול באמצעות @ ייבוא; תחום התיקייה שלו אינו נגזר.

הקשרי אפליקציות#

תחת הקשרי אפליקציות, שמור הוראות והפניות ב־Coroid. הערות ידניות והקשר פרויקט שנוצר ניתנים להפעלה או להשבתה בנפרד מקובצי המאגר. השתמש ברשומות האלה למידע שמקומו מחוץ ל־Git.

הוספת הקשר#

בחר הוסף הקשר והוסף רשומה. לכל אחת יש כותרת ותוכן, וניתן לערוך או להסיר אותה מאוחר יותר.

רשומות טובות הן קצרות, ספציפיות ועמידות. החלטות ארכיטקטורה, מוסכמות סגנון, חוזים של API, גבולות אחריות ואיסורים מפורשים — כולם מתאימים לכאן. תיאור תהליך הקליטה לארגון וכל דבר שכבר ברור מהמאגר אינם מתאימים.

שמור רשומות נפרדות ובעלות שם#

רשומה אחת לנושא, עם כותרת המתארת את תוכנה. "כללי טיפול בשגיאות" ו"מודולים קפואים" ניתנים לאיתור; רשומה אחת בשם "הערות" המכילה את שניהם – לא.

דבר זה חשוב מכיוון שההקשר נטען באופן סלקטיבי בהתאם לעבודה הנוכחית – ראה מיומנויות הדרגתיות. רשומות מנותקות היטב מאפשרות לטעון את הרשומה הנכונה עבור המשימה הנכונה.

הפניות#

לצד הרשומות הכתובות ניתן לצרף קישורים ומסמכים המפנים לחומרים השמורים במקום אחר. השתמשו בהם כאשר העותק הרשמי נמצא בוויקי או בכלי עיצוב ואינכם רוצים שעותק נוסף יתיישן.

הקשר לפי משימה#

ההקשר של הפרויקט חל על כל מה שבו. עבור חומרים הקשורים לחלק מסוים של עבודה – כרטיס משימה, דוח לקוח, מסמך עיצוב – צרפו אותם למשימה הספציפית. הערה ייחודית למשימה שנשמרת בהקשר של הפרויקט תהפוך לרעש בכל משימה עתידית.

שמירה על עדכניות#

הקשר מיושן גרוע יותר מהיעדר הקשר, מכיוון שהסוכנים מקבלים אותו כרשמי. כאשר נוהג משתנה, עדכנו את הרשומה באותה פעולה שבה משתנה הקוד.

סקירת מה שקיים#

קראו את ההקשר שלכם מדי פעם כאילו הייתם חדשים. רשומות נצברות, ואלו שנכתבו במהלך מעבר שנגמר לפני שנה הפכו כעת למטעות באופן פעיל.

קשור#

• הקשר של פרויקט (מושג)
• כתבו AGENTS.md עבור הסוכנים שלכם ועבור Coroid.
• מפרטים
• יצירת פרויקט והגדרתו