إذا وصلت ميزة إلى أعلى قائمة الأولويات، وحان وقت أن تشرحها للمهندسين والمصمم قبل أن يبدؤوا، فأنت تحتاج مواصفة. وإذا كنت كتبت مواصفات من قبل، ثم اكتشفت أن أحداً لم يقرأها، أو أن الفريق بنى شيئاً غير الذي في ذهنك، فهذا المقال لك أيضاً.
المواصفة الجيدة ليست أطول وثيقة في الشركة. هي أقصر وثيقة تجعل الجميع يفهمون نفس الشيء: لماذا نبني هذا، ولمن، وكيف سنعرف أنه نجح، وما الذي لن نبنيه. والباقي يأتي من الحوار مع الفريق، لا من الصفحات.
وفي مقالي هندسة المتطلبات ومن فكرة غامضة إلى متطلبات واضحة شرحنا صيغ المتطلبات ووثيقة 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 فشرحنا قالبها في مثال المتطلبات العملي.

متى لا تحتاج مواصفة أصلاً؟
ليس كل عمل يحتاج وثيقة. والقاعدة العملية: كلما زاد عدد الأشخاص الذين يجب أن يفهموا نفس الشيء، وزادت تكلفة الخطأ، زادت حاجتك إلى الكتابة.
| نوع العمل | ما يكفيه |
|---|---|
| إصلاح خطأ 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 صباحاً بتوقيت المتجر» فتكشف فوراً سؤالاً لم يفكر فيه أحد: توقيت المتجر أم توقيت السيرفر؟

وهذه الصيغة طورها 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 | يستطيع الفريق أن يكتب لها اختباراً | «يجب أن يكون التذكير مفيداً للعميل» | اكتب معايير قبول بقيم محددة |

المصدر: مقال 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 علامات المواصفة التي تعمل ضد الفريق، وأهمها:
- كل شيء مكتوب بتفصيل كبير قبل أن يبدأ أي عمل هندسي.
- مراجعة وتوقيع صارم من كل الفرق قبل البدء.
- المصممون والمطورون لا يعرفون متى تغيرت المتطلبات.
- المتطلبات لا تتحدث أصلاً، لأن الجميع وقع عليها.
- مالك المنتج يكتب المتطلبات دون مشاركة الفريق.
والعلاج أن تعامل المواصفة كصفحة حية، لا كعقد. وهذه دورة حياتها العملية:
- المسودة: يكتب مدير المنتج المشكلة والهدف وما لن نفعله. يوم أو يومان.
- المراجعة الأولى: مع قائد الفريق التقني والمصمم قبل أي أحد آخر. فهم يعرفون ما هو ممكن ورخيص، وقد يقترحون حلاً أبسط. ساعة.
- جلسة البداية Kick-off: مع الفريق كله. تقرأ المواصفة معهم، وتسجل أسئلتهم في جدول الأسئلة المفتوحة. ساعة.
- أثناء البناء: كل قرار جديد يكتب في الوثيقة مع تاريخه، ويبلغ الفريق به في قناته. وإذا تغير متطلب بعد البدء، فعدل معايير القبول أولاً، كما شرحنا في استقبال طلب التغيير.
- بعد الإطلاق: أضف قسماً قصيراً بالنتيجة: ماذا حدث لمقياس النجاح بعد 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 لتقسيم القصص، مع أربع رسومات ومثال توضيحي لمنتج فواتير.