מה אתם מנהלים מלבד המסמך?
מסמך הוא רק דרך אחת לתעד החלטה. צריך גם לדעת אילו סעיפים הוסכמו, אילו עדיין בגדר הצעה, מי יענה על שאלות ומה משתנה כשסעיף מתעדכן. כך אפשר להימנע מביצוע עבודה על סמך פרשנויות שונות לאותה בקשה.
אותה גישה יכולה לעזור בפיתוח אפליקציות, בכלים פנימיים, בתנאי מוצר ובכללי תפעול. התחילו מתכונה אחת או מתהליך עבודה אחד במקום לנסות לתעד הכול בבת אחת.
חברו בין המטרה, הדרישה, המפרט וקריטריוני הקבלה
צוותים משתמשים במונחים האלה בדרכים שונות. בדוגמה זו, דרישה מתארת תוצאה נחוצה או אילוץ, מפרט מתעד את ההתנהגות שהוסכמה וקריטריוני קבלה מסבירים כיצד לבדוק אותה. הסכימו על המשמעויות האלה עם האנשים שעובדים יחד.
יעד: לצמצם העתקה ידנית של נתונים
תהליך הדיווח החודשי כולל כיום העתקה ידנית של רשומות. מטרת הייצוא היא להקל על העבודה הזאת.
דרישה: ייצוא הרשומות הדרושות לדוח
איש צוות צריך לייצא את הרשומות של חודש נבחר, במסגרת הרשאות הגישה שלו.
מפרט: הגדירו את הקובץ ואת התנהגותו
הסכימו על העמודות, הסדר שלהן, קידוד הטקסט, פורמט התאריך, ההתנהגות כשאין תוצאות והטיפול בשגיאות. אלו בחירות לצורך הדוגמה, ולא ברירות מחדל אוניברסליות.
קריטריוני קבלה: להפוך את התוצאה לניתנת לבדיקה
הכינו רשומות עם תאריכים והרשאות ידועים, בצעו את הייצוא והשוו את הפלט לתוצאה שסוכמה.
כתבו רעיון אחד שניתן לבדוק בכל פריט
ביטוי כמו „להפוך את הייצוא לנוח” משאיר החלטות חשובות פתוחות. הפרידו בין בחירת תקופה, בחירת שדות לפלט, טיפול במצב שאין התאמות ובדיקת הרשאות, כאשר אפשר לשנות או לאמת כל אחד מהם בנפרד.
השתמשו בתנאים קונקרטיים במקום במילים כמו ״מהיר״ או ״קל״. אם יעד לזמן תגובה חשוב, תעדו לצד המספר גם את עומס העבודה, הסביבה ושיטת המדידה. סמנו באופן ברור ערכים שטרם הוחלט לגביהם.
לפני: ״אפשר ייצוא ל-CSV.״
אחרי: “ייצאו את החודש שנבחר באמצעות העמודות וסדר המיון שסוכמו. הגדירו תוצאות ריקות ובדיקות הרשאה בסעיפים נפרדים.”
הניסוח המעודכן מציין את הבחירות שיש להסכים עליהן ומקל על הקצאת העבודה ובדיקתה. לפני היישום עדיין נדרשות הגדרות מדויקות לשדות.
מספר קטן של שדות להתחלה
מזהה, כותרת ותיאור
תנו לכל פריט מזהה קבוע, כגון REQ-001. ציינו את הנושא, התנאי והתוצאה הצפויה. מזהה קבוע מאפשר להפנות לפריט גם אחרי שינוי הכותרת.
סיבה ומקור
תעדו את הבעיה שהפריט נועד לפתור ואת מקורו, כגון שיחה, בקשה או מסמך תומך.
עדיפות והיקף
הבחינו בין מה שנדרש לגרסה הזו לבין מה שיכול להמתין. הסבירו את סיבת העדיפות; אל תגדירו כל פריט כבעל עדיפות עליונה.
אחראי ומצב ההחלטה
תעדו מי יבהיר את הפריט ואם הוא בטיוטה, בבדיקה או מוסכם. האחראי על הביצוע ומי שמאשר עשויים להיות אנשים שונים.
קריטריוני קבלה ומידע קשור
קשרו את הפריט למפרטים, לעיצובים, למשימות ולרישומי אימות רלוונטיים. עדכנו את הקישורים האלה כאשר הדרישה משתנה.
דוגמה: שלוש דרישות לייצוא CSV חודשי
להלן דוגמה להמחשה בלבד. יש להסכים על שמות השדות ועל אופן ההתנהגות בהתאם למוצר שאתם בונים; הדוגמה אינה מפרט מלא לכל תכונות הייצוא.
REQ-001: רשומות עבור החודש שנבחר
דוגמה למפרט: השתמשו בחודש שנבחר לפי אזור הזמן העסקי שהוסכם עליו, וייצאו מזהה, תאריך רישום וכותרת בקידוד UTF-8, ממוינים לפי תאריך ולאחר מכן לפי מזהה. דוגמה לתנאי קבלה: שלוש רשומות תואמות יפיקו שורת כותרת אחת ובדיוק שלוש שורות נתונים, ללא רשומות מחודשים אחרים.
REQ-002: אין רשומות תואמות
דוגמה למפרט: יש לייצא את שורת הכותרות המוסכמת גם כשאין רשומות תואמות. דוגמה לקבלה: נתוני בדיקה ריקים מפיקים קובץ עם שורת הכותרות וללא שורות נתונים. אם אתם מעדיפים הודעה במקום קובץ, הסכימו על ההתנהגות השונה ותעדו אותה.
REQ-003: הגישה נבדקת לפני הייצוא
דוגמה למפרט: משתמשים ללא הרשאת ייצוא אינם יכולים ליצור את הקובץ, ורשומות שמחוץ לתחום המורשה לא ייכללו. דוגמאות לקבלה צריכות לכלול משתמש ללא הרשאת ייצוא ומשתמש שהגישה שלו לרשומות מוגבלת.
השתמשו בהיררכיה בלי לאבד החלטות פרטניות
קבצו פריטים לפי מטרה או תכונה, ולאחר מכן הציבו תנאים מפורטים תחת הקבוצה המתאימה. לדוגמה: דוחות → ייצוא CSV חודשי → רשומות יעד / פורמט קובץ / תוצאות ריקות / גישה. הציבו את הרקע והשאלות הפתוחות בהערות במקום לערבב אותם בדרישה אחת ארוכה.
אם תנאי אחד משפיע על כמה תכונות, שמרו הפניה ברורה לגרסה המוסכמת במקום להעתיק גרסאות שונות לכל סעיף. לפני השינוי, בדקו אילו מפרטים וסעיפי אימות בהמשך תלויים בו.
הפרידו בין הסכמה, יישום ואימות
״הוסכם״ פירושו שהתוכן אושר עבור היקף העבודה המיועד. אין פירוש הדבר שהתכונה מומשה. גם ״מומש״ אינו מעיד שקריטריוני הקבלה שהוסכמו התקיימו או שהתכונה שוחררה. חשוב לשמור על ההבחנות האלה גלויות גם כשמשתמשים ברשימת סטטוסים פשוטה.
בדקו את המקרה הרגיל, קלט ריק או חסר, הרשאות וכשצריך גם כשלים בשירותים חיצוניים. החליטו אילו ראיות לשמור, מי יבדוק אותן ומי מוסמך לסגור שאלה שלא נפתרה.
תעדו שינוי ואת השפעתו לפני שתתייחסו אליו כמוסכם
בקשה חדשה היא הצעה עד שהאחראים מסכימים כיצד לטפל בה. תעדו את הסיבה לשינוי, את מזהי הפריטים המושפעים ואת ההשפעה על העבודה, התאריכים, המפרטים והאימות. בדקו גם אם השינוי חל על רשומות או על משתמשים שכבר משתמשים בתכונה.
לאחר קבלת ההחלטה, עדכנו את המפרט הנוכחי והודיעו לאנשים המושפעים ממנה. שמרו את הגרסה הקודמת שאושרה או הערת שינוי כאשר צריך להסביר מה השתנה. אל תניחו שכל אישור ותיקון נרשמים אוטומטית בכלי.
בחרו מקום שתוכלו להמשיך לעדכן
לרשימה קטנה עשוי להספיק מסמך משותף או גיליון אלקטרוני. כאשר הדיון, המימוש והאימות מתפרסים על פני כמה כלים, בחרו מקור עיקרי אחד וקשרו ממנו לחומרים הנלווים. העיקר הוא שכולם יוכלו לזהות את התוכן העדכני שהוסכם עליו.
השתמשו ב-AI לטיוטה, ואז אשרו את ההחלטות
בינה מלאכותית יכולה לעזור ברישום דרישות אפשריות, בארגון טיוטה ובהצעת שאלות חסרות. הפרידו בהנחיה בין עובדות מאומתות להנחות ובקשו להשאיר ערכים שטרם הוחלטו כשאלות. בדקו את התוצאה עם האנשים שמכירים את השימוש המיועד.
ב-ReqSpec AI אפשר לארגן דרישות ומפרטים בצורה היררכית ולהיעזר ב-AI ליצירה, לעריכה ולבדיקה. שאלו שאלה ממוקדת כגון ״אילו תנאים לתוצאה ריקה עדיין לא הוגדרו?״ התייחסו לכל תשובה כהצעה שיש לאמת מול התוכן הרשום, ולא כהוכחה לאישור או לשלמות.
התחילו בתכונה אחת ובסקירה אחת
בחרו תכונה אחת, רשמו את התוצאות הנדרשות, הקצו מזהים לפריטים והוסיפו קריטריוני קבלה ושאלות פתוחות. עברו על כך פעם אחת עם אדם רלוונטי, ואז תעדו את ההחלטות ואת האחראי הבא. אוסף קטן ומתוחזק מועיל יותר ממסמך גדול שאיש אינו מעדכן.
ארגנו דרישות ומפרטים באמצעות ReqSpec AI
ReqSpec AI מציע דרך פשוטה לארגן דרישות ומפרטים בנייד ובאינטרנט. גלו את התכונות שלו בעמוד האפליקציה.