إدارة المنتجات الأدلة التقنية

كيف تكتب مواصفة المنتج PRD وقصص المستخدم

قالب مواصفة من صفحة واحدة بمثال كامل، وكيف تقسم الميزة إلى قصص مستخدم بمعايير قبول واضحة، وما الذي لا تضعه فيها.

كيف تكتب مواصفة المنتج PRD وقصص المستخدم

إذا وصلت ميزة إلى أعلى قائمة الأولويات، وحان وقت أن تشرحها للمهندسين والمصمم قبل أن يبدؤوا، فأنت تحتاج مواصفة. وإذا كنت كتبت مواصفات من قبل، ثم اكتشفت أن أحداً لم يقرأها، أو أن الفريق بنى شيئاً غير الذي في ذهنك، فهذا المقال لك أيضاً.

المواصفة الجيدة ليست أطول وثيقة في الشركة. هي أقصر وثيقة تجعل الجميع يفهمون نفس الشيء: لماذا نبني هذا، ولمن، وكيف سنعرف أنه نجح، وما الذي لن نبنيه. والباقي يأتي من الحوار مع الفريق، لا من الصفحات.

وفي مقالي هندسة المتطلبات ومن فكرة غامضة إلى متطلبات واضحة شرحنا صيغ المتطلبات ووثيقة SRS لمشروع كامل. وهنا نركز على ما يكتبه مدير المنتج لميزة واحدة داخل منتج يعمل: المواصفة القصيرة One-pager أو وثيقة متطلبات المنتج PRD، وقصص المستخدم ومعايير قبولها.

سوف نناقش في هذا المقال:

  • أشكال المواصفة، ومتى تختار كل شكل.
  • قالب مواصفة من صفحة واحدة في جدول، مع مثال مكتوب كاملاً.
  • طريقة Amazon في كتابة بيان صحفي قبل البناء PR/FAQ.
  • كيف تقسم الميزة إلى قصص مستخدم User Stories، وتكتب معايير القبول، وتفحصها بقاعدة INVEST.
  • ما الذي لا تضعه في المواصفة، وكيف تبقيها حية بعد أن يبدأ البناء.

الخلاصة السريعة Quick Summary

💡
المواصفة: تشرح لماذا ولمن وكيف نعرف النجاح وما خارج النطاق. ولا تشرح كيف يبني المهندسون.
الطول: صفحة أو صفحتان لميزة واحدة. والوثيقة الأطول لمنتج جديد أو لمشروع بعقد.
الأقسام الأساسية: المشكلة، والهدف والمقياس، والمستخدمون، والافتراضات، وقصص المستخدم، والتصميم، والأسئلة المفتوحة، وما لن نفعله.
قصة المستخدم: صغيرة، ومقسمة عمودياً، ولها معايير قبول بأمثلة وقيم محددة.
INVEST: ست صفات تفحص بها كل قصة قبل أن تدخل العمل.
بعد الكتابة: راجعها مع قائد الفريق التقني والمصمم، وحدثها كلما تغير قرار، واربطها بالنتائج بعد الإطلاق.

أشكال المواصفة Spec Formats

كلمة «مواصفة» تستخدم لوثائق مختلفة جداً في الحجم والغرض. والجدول التالي يضعها جنباً إلى جنب:

الشكلما هوالطول المعتادمتى يناسب
مواصفة من صفحة واحدة One-pagerالمشكلة والهدف والنطاق وما خارجه، بإيجازصفحة إلى صفحتينأغلب الميزات في منتج يعمل
وثيقة متطلبات المنتج PRDنفس الأقسام بتفصيل أكبر، مع قصص المستخدم والتصميم والأسئلةمن 3 إلى 10 صفحاتميزة كبيرة تشترك فيها عدة فرق
وثيقة مواصفة المتطلبات SRSكل متطلبات نظام كامل، وغالباً للتوقيععشرات الصفحاتمشروع بعقد، أو جهة تشترط وثيقة رسمية
بيان صحفي وأسئلة شائعة PR/FAQبيان كأن المنتج أطلق، ثم أسئلة وأجوبةصفحة للبيان، وخمس صفحات أو أقل للأسئلةمنتج جديد أو فكرة كبيرة تحتاج موافقة الإدارة
قصة مستخدم User Storyحاجة صغيرة واحدة مع معايير قبولهابطاقةوحدة العمل اليومية داخل الفريق

والعلاقة بينها ليست «إما أو». المواصفة من صفحة واحدة أو الـ PRD تحمل الصورة الكبيرة، وتنتهي بقائمة قصص مستخدم. والقصص هي ما يدخل قائمة العمل Product Backlog. أما SRS فشرحنا قالبها في مثال المتطلبات العملي.

أربعة مستويات من الأعلى إلى الأسفل: خارطة الطريق فيها بطاقة تذكير آلي قبل الاستحقاق، ثم المواصفة One-pager أو PRD فيها المشكلة والهدف والنطاق وما خارجه، ثم ثلاث قصص مستخدم User Stories، ثم معايير القبول Acceptance Criteria لكل قصة بصيغة Given When Then، وعلى الجانب سؤال كل مستوى: لماذا الآن، ولماذا ولمن وكيف نعرف النجاح، وماذا يريد المستخدم، ومتى نقول إنها انتهت
كل مستوى يجيب عن سؤال مختلف، والمواصفة هي الجسر بين بطاقة الخارطة وقصص المستخدم

متى لا تحتاج مواصفة أصلاً؟

ليس كل عمل يحتاج وثيقة. والقاعدة العملية: كلما زاد عدد الأشخاص الذين يجب أن يفهموا نفس الشيء، وزادت تكلفة الخطأ، زادت حاجتك إلى الكتابة.

نوع العملما يكفيه
إصلاح خطأ Bug أو تعديل نص في شاشةبطاقة في قائمة العمل مع خطوات إعادة المشكلة أو النص الجديد
تحسين صغير يعمل عليه مهندس واحد لأيامقصة مستخدم واحدة بمعايير قبولها
ميزة يعمل عليها الفريق أسبوعين أو أكثرمواصفة من صفحة واحدة
ميزة تشترك فيها فرق أو أقسام مختلفة، مثل المبيعات والدعمPRD أطول، مع قسم لكل فريق عن دوره
منتج جديد أو استثمار كبير يحتاج موافقةPR/FAQ قبل أي مواصفة

قالب المواصفة من صفحة واحدة One-pager

تكتب Atlassian في دليلها عن وثيقة المتطلبات أنها تستخدم قالباً واحداً للفريق كله، حتى يعرف كل قارئ أين يجد كل شيء. والأقسام التي تقترحها: بيانات المشروع (المشاركون والحالة وموعد الإصدار المستهدف)، والأهداف وأهداف العمل، والخلفية والارتباط بالاستراتيجية، والافتراضات، وقصص المستخدم، والتصميم، والأسئلة، وما لن نفعله.

والقالب التالي مبني على هذه الأقسام، وأضفنا إليها مقياس النجاح لأنه ما يربط المواصفة بالنتيجة. والعمود الثالث مثال مكتوب لميزة في منتج فواتير افتراضي، والأرقام فيه توضيحية:

القسمماذا تكتب فيهمثال: تذكير آلي قبل موعد الاستحقاق
البيانات الأساسيةالمالك، والمشاركون، والحالة، والموعد المستهدفالمالك: مدير المنتج. المشاركون: قائد الفريق التقني والمصمم والدعم. الحالة: مسودة. الموعد: نهاية الشهر
المشكلةما الذي يحدث الآن، ولمن، وما الدليلأصحاب المتاجر ينسون متابعة الفواتير قبل موعدها، فيتأخر الدفع. ذكرها 6 من 10 في مقابلات الشهر الماضي
الهدف ومقياس النجاحالنتيجة الرئيسية التي نحركها، والقيمة الحالية والمستهدفةKR1: متوسط أيام التحصيل من 30 إلى 20. نقرأ المقياس بعد 4 أسابيع من الإطلاق
الارتباط بالاستراتيجيةلماذا هذا الآن، ولماذا هو في عمود «الآن» من الخارطةهدف الربع أن يحصل أصحاب المتاجر على أموالهم أسرع، وهذه أعلى فكرة في ترتيب RICE
المستخدمون والموقفمن يستخدم الميزة، ومتىصاحب المتجر الذي يرسل أكثر من 10 فواتير في الشهر، وعميله الذي يستلم الفاتورة
الافتراضاتما نفترض أنه صحيح ولم نتحقق منهأن أغلب العملاء يقرؤون البريد الإلكتروني. أن التذكير لن يزعج العملاء الذين يدفعون دائماً في الموعد
قصص المستخدمقائمة القصص أو روابطها، مع معايير القبولثلاث قصص، في القسم التالي من هذا المقال
التصميمروابط النماذج الأولية Prototypes أو الرسوم، لا وصفها بالكلامرابط نموذج صفحة إعدادات التذكير ونص الرسالة
الأسئلة المفتوحةجدول: السؤال، ومن يجيب، ومتىهل نرسل عبر SMS أيضاً؟ يجيب مدير المنتج بعد حساب التكلفة، خلال أسبوع
ما لن نفعله Out of Scopeما قد يتوقعه القارئ ولن يكون في هذا الإصدارلن نرسل تذكيراً بعد موعد الاستحقاق. لن نسمح بتعديل نص الرسالة في هذا الإصدار

المصدر: دليل Atlassian لكتابة وثيقة متطلبات المنتج PRD (Dan Radigan).

صفحة واحدة مقسمة إلى أقسام ملونة: في الأعلى البيانات الأساسية، ثم المشكلة مع الدليل، ثم الهدف ومقياس النجاح، ثم المستخدمون والافتراضات، ثم قصص المستخدم، ثم التصميم والأسئلة المفتوحة، وفي الأسفل بخط أحمر ما لن نفعله، وبجانبها ملاحظة أن أهم ثلاثة أقسام هي المشكلة والمقياس وما لن نفعله
إذا لم يقرأ أحد غير ثلاثة أقسام، فلتكن المشكلة ومقياس النجاح وما لن نفعله

ملاحظات على القالب

  • المشكلة تكتب قبل الحل. وإذا لم تستطع كتابتها في جملتين مع دليل، فالميزة لم تنته من مرحلة الاكتشاف بعد. ارجع إلى اكتشاف المنتج قبل أن تكمل.
  • مقياس النجاح يكتب قبل البناء. والسبب أنك إذا كتبته بعد الإطلاق، ستختار المقياس الذي تحسن. وشرحنا اختيار المقاييس في مقاييس المنتج.
  • الافتراضات ليست حقائق. كتابتها تجعل الفريق يعرف ما الذي قد يتغير. وتنصح Atlassian بالرجوع إليها أثناء العمل، لأن معلومات جديدة ستظهر.
  • الأسئلة المفتوحة في جدول. السؤال الذي ليس له صاحب وموعد سيبقى مفتوحاً حتى يقرر المهندس وحده في منتصف الليل.
  • ما لن نفعله أهم قسم بعد المشكلة. تقول Atlassian إنه يبقي الفريق مركزاً على العمل الحالي، ويوضح ما قد يأتي لاحقاً. وهو أيضاً ما ستشير إليه عندما يطلب أحد إضافة «صغيرة» في منتصف الدورة.

طريقة Amazon: البيان الصحفي قبل البناء PR/FAQ

عندما تكون الفكرة كبيرة، مثل منتج جديد أو خط أعمال، تستخدم Amazon طريقة اسمها «العمل من النهاية» Working Backwards. وتقول الشركة إنها استخدمتها لأغلب منتجاتها ومبادراتها الكبيرة منذ 2004. والأداة الأساسية فيها وثيقة PR/FAQ:

  • البيان الصحفي Press Release: فقرات قليلة، أقل من صفحة دائماً، مكتوبة كأن المنتج أطلق اليوم. تشرح لمن هو، وما المشكلة التي يحلها، ولماذا هو أفضل مما هو موجود.
  • الأسئلة الشائعة FAQ: خمس صفحات أو أقل، تجيب عن أسئلة العملاء وأسئلة الإدارة الداخلية، مثل التكلفة والمخاطر.

والفكرة أن الكتابة من وجهة نظر العميل تكشف ضعف الفكرة مبكراً. فإذا لم تستطع أن تكتب بياناً صحفياً يقنع أحداً، فالمنتج غالباً لا يستحق البناء. وتذكر الشركة أن الفرق تكتب عادة عشر مسودات أو أكثر، وتلتقي بالإدارة خمس مرات أو أكثر قبل القرار. وتقول جملة تستحق أن تعلقها فوق مكتبك: «لا توجد جوائز للصفحات الزائدة أو الكلمات الزائدة».

ومتى تستخدمها؟ عندما تحتاج موافقة على فكرة كبيرة لم تبدأ بعد. أما الميزة داخل منتج يعمل فتكفيها المواصفة من صفحة واحدة.

المصدر: مقتطف من كتاب Working Backwards لـ Colin Bryar وBill Carr على موقع Amazon (فبراير 2021).

قصص المستخدم User Stories

قصة المستخدم وصف قصير لحاجة واحدة من وجهة نظر صاحبها، بالقالب المشهور: «بصفتي… أريد… حتى…». وشرحنا القالب وأصله في هندسة المتطلبات. والسؤال الذي يواجهه مدير المنتج في العمل اليومي ليس صيغة القصة، وإنما: كيف أقسم ميزة كاملة إلى قصص؟

قسم الميزة عمودياً Vertical Slicing، لا طبقات

الخطأ الشائع أن تقسم الميزة حسب طبقات النظام: قصة لقاعدة البيانات، وقصة للواجهة الخلفية Backend، وقصة للشاشة. والنتيجة أن أي قصة وحدها لا تعطي المستخدم شيئاً، ولا يمكن اختبارها معه.

وينصح Bill Wake، صاحب قاعدة INVEST، بالتقسيم العمودي: كل قصة تمر بكل الطبقات، وكل قصة لها قيمة يراها المستخدم وحدها. وهكذا يمكن تقسيم ميزة التذكير:

القصةالنصلماذا هي وحدة مستقلة
1بصفتي صاحب متجر، أريد أن يصل لعميلي تذكير بالبريد قبل موعد الاستحقاق بثلاثة أيام، حتى يدفع في الموعد دون أن أتابعه بنفسيأبسط نسخة تعطي القيمة الأساسية، ويمكن قياس أثرها
2بصفتي صاحب متجر، أريد أن أوقف التذكير لعميل محدد، حتى لا أزعج عملائي الكبار الذين أتعامل معهم مباشرةتعالج افتراضاً في المواصفة، ويمكن إطلاقها بعد الأولى
3بصفتي صاحب متجر، أريد أن أرى في صفحة الفاتورة متى أرسل التذكير، حتى أعرف أن العميل وصلهتبني الثقة بالميزة، وليست شرطاً لعملها

ولاحظ أن القصة الأولى وحدها تكفي لإطلاق تجربة وقياس المقياس. وإذا لم يتحرك المقياس، فقد وفرت على الفريق بناء القصتين الأخريين.

وإذا كانت القصة غير واضحة بما يكفي لتقديرها، يقترح Wake قصة صغيرة محددة بوقت تسمى Spike، هدفها فقط جمع المعلومات اللازمة للتقدير، مثل تجربة مزود إرسال البريد.

أنماط تقسيم القصص Story Splitting Patterns

ماذا تفعل عندما تكون القصة كبيرة ولا تعرف من أين تقسمها؟ جمع Richard Lawrence وPeter Green من Humanizing Work أنماطاً متكررة للتقسيم. وينصحان قبل التقسيم بأن تفحص القصة بقاعدة INVEST ما عدا صفة «صغيرة»، لأن أكثر صفة تفشل فيها القصص هي «ذات قيمة». فإذا كانت القصة مهمة تقنية فقط، فاجمعها مع غيرها حتى تعطي قيمة، ثم قسم.

والجدول التالي يطبق أهم الأنماط على ميزة التذكير:

النمطالفكرةتطبيقه على التذكير
خطوات سير العمل Workflow Stepsابن الحالة البسيطة من البداية إلى النهاية أولاً، ثم أضف الخطوات الوسطىتذكير واحد قبل الموعد أولاً، ثم تذكير ثان يوم الموعد
العمليات Operationsقصة «إدارة» تقسم إلى إضافة وتعديل وإلغاء«إدارة إعدادات التذكير» تصبح: تفعيل، ثم تغيير عدد الأيام، ثم إيقاف لعميل
اختلاف قواعد العمل Business Rule Variationsكل قاعدة في قصةقاعدة الفواتير العادية أولاً، ثم قاعدة الفواتير المقسطة
اختلاف البيانات Variations in Dataأبسط شكل للبيانات أولاً، ثم الاختلافاترسالة بالعربية أولاً، ثم اختيار لغة الرسالة حسب العميل
البسيط ثم المعقد Simple/Complexأبسط نسخة قصة مستقلة، وكل تعقيد قصةالبريد أولاً، ثم SMS، ثم واتساب إذا ثبت أثر التذكير
تأجيل الأداء Defer Performanceنسخة تعمل ببطء أولاً، ثم تسريعهاإرسال دفعة واحدة كل ساعة أولاً، ثم إرسال فوري عند الحاجة
قصة استكشاف Spikeبحث محدد بوقت لإزالة الغموض، كآخر حليومان لتجربة مزود البريد وقياس نسبة الوصول

والفكرة التي تجمعها كلها: ابحث عن مصدر التعقيد في القصة، واعرف أشكاله، ثم ابدأ بشكل واحد كامل من البداية إلى النهاية.

المصدر: دليل Humanizing Work لتقسيم قصص المستخدم.

معايير القبول Acceptance Criteria

معايير القبول هي الشروط التي يجب أن تتحقق حتى تعتبر القصة منتهية. وأشهر صيغة لها ثلاث كلمات: «بفرض» Given حالة البداية، و«عندما» When يحدث شيء، و«إذاً» Then النتيجة المتوقعة. وهذه معايير القصة الأولى:

الحالةبفرض Givenعندما Whenإذاً Then
الحالة العاديةفاتورة غير مدفوعة موعد استحقاقها 15 مارس، وللعميل بريد صحيحيصل التاريخ إلى 12 مارس الساعة 9 صباحاً بتوقيت المتجريصل للعميل بريد واحد فيه رقم الفاتورة والمبلغ ورابط عرضها
الفاتورة مدفوعةفاتورة دفعت يوم 10 مارس، وموعدها 15 مارسيصل التاريخ إلى 12 مارسلا يرسل أي تذكير
موعد قريبفاتورة أنشئت يوم 14 مارس، وموعدها 15 مارستحفظ الفاتورةلا يرسل تذكير قبل الموعد، لأن المدة أقل من ثلاثة أيام
بريد غير صالحبريد العميل يرتد Bounceيحاول النظام الإرساليظهر لصاحب المتجر تنبيه في صفحة الفاتورة أن التذكير لم يصل

لاحظ أن كل سطر يحمل قيماً محددة: تاريخ وساعة وحالة. والجملة العامة مثل «يجب إرسال التذكير في الوقت المناسب» لا تكشف سوء الفهم. أما «12 مارس الساعة 9 صباحاً بتوقيت المتجر» فتكشف فوراً سؤالاً لم يفكر فيه أحد: توقيت المتجر أم توقيت السيرفر؟

بطاقة قصة مستخدم: في الأعلى بصفتي صاحب متجر أريد أن يصل لعميلي تذكير بالبريد قبل موعد الاستحقاق بثلاثة أيام حتى يدفع في الموعد، وتحتها أربعة صفوف معايير قبول بصيغة Given When Then للحالة العادية والفاتورة المدفوعة والموعد القريب والبريد غير الصالح، وفي الأسفل علامات المقياس KR1 والمالك وحجم القصة
القصة تقول ماذا يريد المستخدم ولماذا، ومعايير القبول تقول متى نعتبرها منتهية، بقيم محددة

وهذه الصيغة طورها Daniel Terhorst-North وChris Matts ضمن منهج التطوير الموجه بالسلوك BDD. وميزتها أن صاحب العمل يقرؤها ويوافق عليها، وأن المهندسين يستطيعون تحويلها إلى اختبارات آلية بلغة Gherkin، وهي تدعم العربية. وليس عليك أن تستخدم هذه الصيغة دائماً. قائمة نقاط واضحة تكفي للقصص البسيطة، والمهم أن تكون قابلة للفحص.

المصدر: Martin Fowler عن Given When Then، ومرجع Gherkin.

افحص القصة بقاعدة INVEST

نشر Bill Wake قاعدة INVEST سنة 2003، وهي ست صفات للقصة الجيدة. والجدول التالي يضع كل صفة مع مثال لقصة تخالفها، ثم كيف تصلحها:

الصفةمعناها عند Wakeقصة تخالفهاالإصلاح
مستقلة Independentلا تتداخل مع غيرها، ويمكن ترتيبها بأي ترتيب قدر الإمكان«إرسال التذكير» و«قالب رسالة التذكير» قصتان منفصلتاناجمعهما: القصة الأولى ترسل برسالة ثابتة بسيطة
قابلة للتفاوض Negotiableليست عقداً ثابتاً، والتفاصيل تتضح بالحوارقصة فيها لون الزر ونص كل حقل واسم الجدول في قاعدة البياناتاكتب الحاجة، واترك التفاصيل للحوار مع المصمم والمهندس
ذات قيمة Valuableلها قيمة يراها العميل«إنشاء جدول التذكيرات في قاعدة البيانات»قسم عمودياً كما في القسم السابق
قابلة للتقدير Estimableمفهومة بما يكفي لتقدير حجمها وترتيبها«دعم كل قنوات التواصل»حدد القناة، أو ابدأ بـ Spike قصير
صغيرة Smallعادة لا تزيد على أسابيع قليلة من العمل، وبعض الفرق تحدها بأيام«نظام التذكيرات كاملاً»قسمها إلى قصص تنتهي كل منها داخل دورة عمل واحدة Sprint
قابلة للاختبار Testableيستطيع الفريق أن يكتب لها اختباراً«يجب أن يكون التذكير مفيداً للعميل»اكتب معايير قبول بقيم محددة
ستة مربعات لحروف INVEST: I مستقلة Independent مع سؤال هل تبدأ دون انتظار قصة أخرى، وN قابلة للتفاوض Negotiable مع سؤال هل تصف الحاجة لا التفاصيل، وV ذات قيمة Valuable مع سؤال هل يرى المستخدم فائدتها وحدها، وE قابلة للتقدير Estimable مع سؤال هل يستطيع الفريق تقدير حجمها، وS صغيرة Small مع سؤال هل تنتهي في دورة واحدة، وT قابلة للاختبار Testable مع سؤال هل لها معايير قبول بقيم محددة
ستة أسئلة قبل أن تدخل القصة قائمة العمل، والقصة التي تفشل في سؤالين أو أكثر تعود إلى صاحبها

المصدر: مقال Bill Wake: INVEST in Good Stories, and SMART Tasks (2003)، وتعريف INVEST في Agile Alliance.

ما الذي لا تضعه في المواصفة؟

المواصفة تكبر بسرعة، وكل سطر زائد يقلل احتمال أن يقرأها أحد. وهذه الأشياء التي تخرجها منها:

لا تضعلماذاأين يذهب بدلاً من ذلك
طريقة البناء: الجداول، والخدمات، ولغة البرمجةهذا قرار المهندسين، وتقول Atlassian إن الفريق مؤهل لتفاصيل التنفيذ عندما يفهم العميلوثيقة تصميم تقني يكتبها الفريق، وشرحنا قالبها في مقال RFC
وصف الشاشات بالكلام، زراً زراًالصورة أوضح، والمصمم هو صاحب القرار فيهارابط النموذج الأولي في قسم التصميم
حل مكتوب كأنه متطلب: «زر أخضر يرسل SMS»يغلق الباب أمام حلول أفضلاكتب الحاجة في القصة، والحل يأتي من الحوار
كلمات بلا أرقام: «سريع»، «سهل»، «آمن»كل قارئ يفهمها بطريقتهرقم يقاس، مثل «يرسل التذكير خلال 5 دقائق من موعده». وشرحنا كتابتها في المتطلبات غير الوظيفية
كل حالة استثنائية يمكن تخيلها، مقدماًأغلبها يظهر في الحوار وأثناء البناءمعايير القبول للحالات المهمة، والباقي في الأسئلة المفتوحة
تاريخ النقاشات ومن قال ماذايجعل الوثيقة سجلاً للاجتماعات، لا مرجعاًسجل قرارات قصير في آخر الوثيقة: القرار وتاريخه وسببه
وعود لعملاء بأسمائهمتحول الميزة إلى مشروع لعميل واحدالمشكلة المشتركة بين العملاء، وعدد من طلبها

مثال: فقرة ضعيفة من مواصفة وإصلاحها

هذه فقرة نراها كثيراً في المواصفات، ثم نفس المعنى بعد الإصلاح:

قبلبعدما الذي تغير
«نحتاج نظام تذكيرات قوياً وسهل الاستخدام»«أصحاب المتاجر ينسون متابعة الفواتير قبل موعدها. ذكرها 6 من 10 في المقابلات»مشكلة مع دليل بدل وصف للحل بصفات عامة
«يرسل النظام التذكيرات عبر جدول جديد وخدمة خلفية كل دقيقة»«يصل التذكير للعميل قبل الاستحقاق بثلاثة أيام، خلال 5 دقائق من الساعة 9 صباحاً بتوقيت المتجر»النتيجة التي يراها المستخدم بدل طريقة البناء
«نتوقع أن تتحسن نسبة التحصيل»«KR1: متوسط أيام التحصيل من 30 إلى 20، نقرؤه بعد 4 أسابيع»رقم وموعد قياس بدل توقع
«سندعم كل القنوات لاحقاً»«لن نرسل SMS أو واتساب في هذا الإصدار. نقرر بعد قراءة KR1»حد واضح للنطاق، وشرط لإعادة النقاش

مواصفة حية لا وثيقة توقيع

تذكر Atlassian علامات المواصفة التي تعمل ضد الفريق، وأهمها:

  • كل شيء مكتوب بتفصيل كبير قبل أن يبدأ أي عمل هندسي.
  • مراجعة وتوقيع صارم من كل الفرق قبل البدء.
  • المصممون والمطورون لا يعرفون متى تغيرت المتطلبات.
  • المتطلبات لا تتحدث أصلاً، لأن الجميع وقع عليها.
  • مالك المنتج يكتب المتطلبات دون مشاركة الفريق.

والعلاج أن تعامل المواصفة كصفحة حية، لا كعقد. وهذه دورة حياتها العملية:

  1. المسودة: يكتب مدير المنتج المشكلة والهدف وما لن نفعله. يوم أو يومان.
  2. المراجعة الأولى: مع قائد الفريق التقني والمصمم قبل أي أحد آخر. فهم يعرفون ما هو ممكن ورخيص، وقد يقترحون حلاً أبسط. ساعة.
  3. جلسة البداية Kick-off: مع الفريق كله. تقرأ المواصفة معهم، وتسجل أسئلتهم في جدول الأسئلة المفتوحة. ساعة.
  4. أثناء البناء: كل قرار جديد يكتب في الوثيقة مع تاريخه، ويبلغ الفريق به في قناته. وإذا تغير متطلب بعد البدء، فعدل معايير القبول أولاً، كما شرحنا في استقبال طلب التغيير.
  5. بعد الإطلاق: أضف قسماً قصيراً بالنتيجة: ماذا حدث لمقياس النجاح بعد 4 أسابيع؟ وماذا قررنا: نبقي أو نحسن أو نحذف؟

والخطوة الأخيرة هي التي تنساها أغلب الفرق. ومع الوقت تصبح المواصفات القديمة مع نتائجها أفضل مرجع لتقدير الأفكار القادمة.

أخطاء شائعة

الخطأماذا تفعل بدلاً منه
تبدأ المواصفة بالحل وتنسى المشكلةالمشكلة مع دليلها في أول قسم، والحل في القصص
لا يوجد مقياس نجاح، أو يكتب بعد الإطلاقاكتب النتيجة الرئيسية وقيمتها الحالية قبل البناء
عشرون صفحة لميزة صغيرةصفحة أو صفحتان، والتفاصيل في الحوار ومعايير القبول
قصص مقسمة حسب الطبقاتقسم عمودياً، وكل قصة لها قيمة يراها المستخدم
معايير قبول عامة بلا قيمأمثلة بتواريخ وأرقام وحالات محددة
لا يوجد قسم «ما لن نفعله»اكتبه دائماً، فهو ما يحمي النطاق في منتصف العمل
المواصفة تكتب وتوقع ثم لا تتغيرصفحة حية مع سجل قرارات، وقسم للنتيجة بعد الإطلاق
المهندسون يرون المواصفة أول مرة في جلسة البدايةراجعها مع قائد الفريق التقني والمصمم قبل ذلك

قائمة تحقق Checklist قبل أن تسلم المواصفة للفريق

  • هل المشكلة مكتوبة في جملتين مع دليل من مقابلات أو بيانات؟
  • هل مقياس النجاح مكتوب مع قيمته الحالية وموعد قراءته بعد الإطلاق؟
  • هل ترتبط الميزة بهدف في خارطة الطريق؟
  • هل الافتراضات مكتوبة، وتعرف أيها الأخطر؟
  • هل القصص مقسمة عمودياً، وكل قصة تمر بفحص INVEST؟
  • هل لكل قصة معايير قبول بقيم محددة، بما فيها الحالات المهمة غير العادية؟
  • هل التصميم روابط لا وصف بالكلام؟
  • هل لكل سؤال مفتوح صاحب وموعد؟
  • هل قسم «ما لن نفعله» موجود وواضح؟
  • هل راجعها قائد الفريق التقني والمصمم؟

الخلاصة

  • المواصفة تشرح لماذا ولمن وكيف نعرف النجاح وما خارج النطاق. وطريقة البناء قرار المهندسين.
  • صفحة أو صفحتان تكفي أغلب الميزات. وPR/FAQ للأفكار الكبيرة التي تحتاج موافقة، وSRS للمشاريع بعقود.
  • أهم ثلاثة أقسام: المشكلة مع دليلها، ومقياس النجاح، وما لن نفعله.
  • قسم الميزة إلى قصص عمودية، كل قصة لها قيمة وحدها، وأبسطها يكفي لقياس الأثر.
  • معايير القبول أمثلة بقيم محددة، وINVEST ست أسئلة قبل أن تدخل القصة العمل.
  • المواصفة صفحة حية: تتحدث مع كل قرار، وتنتهي بنتيجة الإطلاق.

وفي المقال التالي من هذه المرحلة نتحدث بإذن الله عن الموقف الأصعب: عميل كبير يطلب ميزة ليست في الخارطة، فكيف ترفضها أو تؤجلها دون أن تخسره؟

دليلكيف ترفض طلب ميزة Feature Request من عميل كبيركيف تفهم الحاجة خلف طلب العميل، وتقيمه بمعايير وتكلفة، وترد بقرار واضح وبديل يحافظ على العلاقة.دليلخارطة طريق المنتج Product Roadmap وربطها بالأهدافكيف تختار نوع خارطة الطريق، وتربطها بأهداف OKRs، وتعرضها لكل جمهور دون أن تعد بتواريخ لا تستطيع الوفاء بها.دليلطرق ترتيب الأولويات Prioritization ومتى تستخدم كلاً منهاكيف ترتب الأفكار والطلبات بطرق مثل RICE وKano بأمثلة محسوبة، ومتى تناسب كل طريقة، وكيف يساء استخدامها.دليلهندسة المتطلبات Requirements Engineering من الطلب إلى ما يبنىما هو المتطلب Requirement، وكيف تجمعه وتكتبه وتراجعه وتدير تغييره، ولماذا تفشل مشاريع كبيرة عندما تهمل هذه الخطوة.دليلمن فكرة غامضة إلى متطلبات Requirements واضحة: خطوات وقوالبثماني خطوات بقوالب جاهزة تحول طلباً من سطر واحد إلى متطلبات Requirements واضحة يوقع عليها العميل ويبني عليها الفريق.دليلاكتشاف المنتج Product Discovery: تحقق قبل أن تبنيكيف تعرف أن المشكلة حقيقية وأن الحل ينفع بمقابلات ونماذج أولية وتجارب رخيصة، قبل أن تصرف أشهراً على البناء.

سجل التحديثات

  • 2026-11-16: كتابة المقال من دليل Atlassian لوثيقة متطلبات المنتج، ومقتطف كتاب Working Backwards على موقع Amazon، ومقال Bill Wake عن INVEST (2003)، وMartin Fowler عن Given When Then، ومرجع Gherkin، ودليل Humanizing Work لتقسيم القصص، مع أربع رسومات ومثال توضيحي لمنتج فواتير.
نشرة عرب رووت | ArabRoot

معرفة تستحق مكاناً في بريدك.

مقالات مختارة وأدوات مفيدة وأفكار لمشروعك القادم، في رسالة واحدة كل أسبوع.

يمكنك إلغاء الاشتراك متى شئت. الخصوصية

تم استلام طلبك. افتح بريدك واضغط رابط التأكيد لإتمام الاشتراك.