תיעוד

גלה

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

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

עם מי לדבר

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

שאלות לשאול

שאלו על תוצאות וחששות, לא על הגדרות. הלקוח אומר "אף אחד לא משנה קוד תשלום בלי ביקורת". תמצאו את ההגדרה מאוחר יותר.

מטרות

  • מה חייב להשתנות לאחר 90 יום? בקשו מדד ואת הערך שלו כיום, למשל "תקלות התומכות בדוחות נתונות בתיקון תוך שבוע".
  • איזה עבודה חייבת ה־CoRoid לבצע קודם? איזו עבודה אסור לה לבצע?
  • מי מבקש עבודה כיום? מי יבקש מה־CoRoid לבצע עבודה?

מערכות

  • איזה מארח Git ואילו מאגרים? האם ה־CoRoid יכול להגיע למארח Git דרך האינטרנט הציבורי?
  • כיצד כל מאגר בונה ומריץ את הבדיקות שלו? אילו שירותים נדרשים לבדיקות?
  • כיצד נכנסים למערכת כיום? האם החברה משתמשת בספק זהויות עם ה־SSO?
  • איזה כלי צ'אט משתמש הצוות?
  • מאין מגיעה העבודה כיום: מעקב אחר בעיות, מעקב אחר שגיאות, תיבת דוא״ל לתמיכה, כלי ניטור?
  • אילו מערכות פנימיות חייבות הסוכנים לקרוא או לשנות? האם יש עבורן שרת MCP?
  • כיצד מגיע הקוד לסביבת ייצור? מי מבצע את הפריסה, ובאילו ימים?

כללים

  • היכן חייבים הנתונים להישאר? האם שיחות עם מודלים של ה־AI חייבות להתקיים באיחוד האירופי?
  • אילו ספקי מודלים מותרים? האם ללקוח יש חוזים ומפתחות משלו מול ספקי המודלים?
  • איזה קוד זקוק לאישור של אדם מסוים לפני מיזוגו? מי נותן את האישור?
  • מה חייב כל שינוי לעבור: בדיקות, כיסוי קוד, סריקות אבטחה, תרגומים?
  • מה מותר ל־CoRoid להתחיל ללא התערבות אדם? כמה מותר לו לבזבז בשבוע או בחודש?
  • מה חייב רישום עקבות הביקורת לכלול, ולכמה זמן יש לשמור אותו?

תהליכים

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

אנשים

  • מי הם הבעלים והמנהלים? מי מבקש עבודה, ומי רק בוחן?
  • מי יתחזק את ההגדרות לאחר המסירה?

מסמך הגילוי

השאירו את המסמך קצר. השתמשו בפרקים האלה, בסדר זה.

  1. מטרות. התוצאות ליום ה־90, כל אחת עם מדד וערכו כיום.
  2. מערכות. מארח ה־Git והמאגרים, כניסה למערכת, צ'אט, עקבות בעיות ושגיאות, כלים פנימיים, ודרך הייצור.
  3. כללים. היכן נשארים הנתונים, מודלים מותרים, אישורים, הבדיקות שכל שינוי חייב לעבור, תקציבים, ביקורת ושמירה.
  4. תהליכים לכיסוי. עבור כל פרויקט וזרם: מה הוא כולל, מי בעל האחריות עליו, וכיצד יודעים שהוא פועל.
  5. אנשים. תפקידו של כל אדם ב־CoRoid, ומי יתחזק את ההגדרות לאחר המסירה.
  6. שאלות פתוחות. מה שעדיין צריך הלקוח להחליט, ועד מתי.

עבור כל כלל, רשמו היכן הוא יוגדר. הגדירו מפרט את כל המקומות. כלל שאין לו הגדרה מתאימה הוא בקשה ל־CoRoid. ראו צורך שאין לו כיסוי.

הושלם כאשר

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