Architecture Decision Record

Active theme: Light

← מסמכים

מי יכול ליצור ADR?

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

דוגמה לתשובה: כל אדם בארגון שלנו שקרא את דף ה-README של רשומת ההחלטה הארכיטקטונית יכול להציע ADR, כלומר יכול להתחיל לכתוב אותה ולשתף אותה עם הצוות.

מה מצדיק פתיחת ADR?

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

דוגמה לתשובה: אנחנו רוצים ליצור ADR כשאנחנו רוצים שמפתחים בעתיד יבינו את ה"למה" של מה שאנחנו עושים.

מה מצדיק לא לפתוח ADR?

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

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

מהו מחזור החיים של ADR?

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

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

מהם הקריטריונים לשלבי מחזור החיים של ADR?

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

דוגמה לתשובה: אנחנו רוצים שבעלי העניין יצביעו על ADR כשהצוות הפעיל 1) השלים את המחקר שלו, 2) השלים את ההערכה שלו, 3) פרסם את הצעת ה-ADR לבעלי העניין עם בקשה להערות ומסגרת זמן של שבוע, 4) כל הערות בעלי העניין שולבו ונענו.

אילו תפקידים ואחריות מתקשרים עם ADR?

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

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

איך ממשל מתקשר עם ADR?

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

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

אילו עקרונות מתקשרים עם ADR?

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

דוגמה לתשובה: אנחנו משתמשים בעקרונות ההנהגה של הטיה לפעולה, התנגדות ומחויבות (disagree-and-commit), הערכות של 70% מספיקות להחלטות הפיכות וניתנות לבידוד בקלות, ודרכי עבודה פומביות למעט מידע סודי כפי שמתואר בהסכם הסודיות של הארגון שלנו.