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