قالب وثيقة متطلبات المنتج (PRD)
ست وثائق مترابطة تأخذ ميزة من المشكلة إلى الإطلاق: لمن هي، وما الذي يجب أن تفعله، وكيف يسير مسارها، وكيف تعرف أنها نجحت، وكل قرار على الطريق. نزّلها ملفات Markdown: تفتح في أي محرر، وتعرض مخططها على GitHub وفي Obsidian، وتُستورد إلى Nodary على شكل خريطة.
6 ملفات Markdown في ملف .zip، 9 كيلوبايت
مجاني، بلا حساب وبلا بريد إلكتروني. استخدمه وعدّله وشاركه.
اقرأ كل صفحة قبل التنزيل
تتسع النظرة العامة لشاشة واحدة وتربط بخمسة أجزاء، فيجد التطوير والتصميم والدعم كلٌّ صفحته، ويبقى التعديل صغيرًا. الأسطر المائلة تقول ما يُكتب؛ والأمثلة تتبع ميزة نموذجية واحدة: روابط مشاركة تنتهي صلاحيتها.
المستندات
الملف قالب PRD/وثيقة متطلبات المنتج.md
وثيقة متطلبات المنتج
طريقة الاستخدام: الأسطر المائلة إرشادات. استبدلها بكلماتك ثم احذفها. القيم بين الأقواس المربعة تملؤها أنت. أبقِ هذه الصفحة في شاشة واحدة: فهي أول ما يقرؤه القارئ المستعجل أو الزميل الجديد أو وكيل الذكاء الاصطناعي.
باختصار
| الحقل | هذه الميزة |
|---|---|
| الميزة | [الاسم] |
| في جملة | [ما يستطيع المستخدم فعله بعد صدورها] |
| مالك المنتج | [الاسم] |
| القائد التقني | [الاسم] |
| قائد التصميم | [الاسم] |
| الحالة | [مسودة، قيد المراجعة، معتمدة، صادرة] |
| الإصدار المستهدف | [التاريخ أو الإصدار] |
المشكلة
من يعاني المشكلة، وكم تكلّفه اليوم، وكيف تعرف ذلك. المشكلة بلا دليل مجرد تخمين: اربط البحث في المستخدمون والأدلة.
مثال (ميزة نموذجية): يشارك البعض مستندًا مع عميل لمراجعته، ثم ينسون أن الرابط موجود. وبعد أشهر يظل يفتح. وفي الربع الماضي سأل ثلاثة عملاء كيف يجعلون رابطًا يتوقف عن العمل في تاريخ محدد.
[المشكلة في جملتين أو ثلاث]
الأهداف وغير الأهداف
الأهداف تقول ما الذي يتغير للمستخدم، لا ما يبنيه الفريق. وغير الأهداف هي القرارات التي تمنع النطاق من الاتساع بصمت.
- هدف: [ما يستطيع المستخدم فعله، أو ما لم يعد مضطرًا لفعله]
- هدف: [...]
- غير هدف: [ما يتركه هذا الإصدار عمدًا]
- غير هدف: [...]
النجاح في سطر
المؤشر الواحد الذي يخبرك، بعد شهر من الإطلاق، إن كان الأمر قد نجح. القائمة الكاملة في الإطلاق والمؤشرات.
[المؤشر] ينتقل من [القيمة الأساسية] إلى [الهدف] بحلول [التاريخ].
بقية الوثيقة
كل جزء مستند مستقل. اربط به بدل أن تنسخ منه، فتعيش كل معلومة في مكان واحد وتتغير في مكان واحد.
- المستخدمون والأدلة: لمن الميزة، والبحث وراء المشكلة
- المتطلبات: ما يجب أن تفعله، مع الأولويات ومعايير القبول
- التصميم والمسارات: المسار والشاشات والحالات والحالات الحدّية
- الإطلاق والمؤشرات: المؤشرات والطرح وقائمة تحقق الإطلاق
- القرارات والأسئلة المفتوحة: ما تقرر ومن قرر ولماذا، وما يبقى مفتوحًا
هذا القالب حر الاستخدام والتعديل والمشاركة. وهو من Nodary، حيث تُستورد هذه الملفات خريطةً من المستندات المترابطة.
الملف قالب PRD/وثيقة متطلبات المنتج/01 المستخدمون والأدلة.md
المستخدمون والأدلة
لمن الميزة وما تعرفه عنهم. يجب أن تشير كل عبارة هنا إلى مصدرها.
لمن هي
| من | ما يحاول فعله | ما يعيقه |
|---|---|---|
| [المستخدم الرئيسي] | [...] | [...] |
| [مستخدم ثانوي] | [...] | [...] |
مثال (ميزة نموذجية): تشارك مديرة حسابات مسودة عرض مع عميل لأسبوع من التعليقات. واليوم تضبط تذكيرًا لإيقاف الرابط، وتنساه أحيانًا.
اليوم، من دون الميزة
ما يفعله المستخدمون اليوم خطوة بخطوة، بما في ذلك الحلول الالتفافية. فالحل الالتفافي كثيرًا ما يكون أفضل مواصفات تحصل عليها.
- [خطوة]
- [خطوة]
- [حل التفافي]
الأدلة
| المصدر | ما يقوله | التاريخ | الرابط |
|---|---|---|---|
| [مقابلة عميل] | [...] | [التاريخ] | [...] |
| [تذاكر الدعم] | [...] | [...] | [...] |
| [بيانات الاستخدام] | [...] | [...] | [...] |
أسئلة مفتوحة
- [السؤال]، [من يجيب عنه]، [الموعد النهائي]
الملف قالب PRD/وثيقة متطلبات المنتج/02 المتطلبات.md
المتطلبات
سطر لكل متطلب، مكتوبًا كشيء يستطيع المستخدم فعله. الأولوية إلزامي أو مهم أو اختياري: يصدر الإصدار حين يتحقق كل إلزامي.
قصص المستخدم
| المعرّف | بصفتي | أريد أن | لكي | الأولوية |
|---|---|---|---|---|
| R1 | [مستخدم] | [...] | [...] | [إلزامي، مهم، اختياري] |
| R2 | [...] | [...] | [...] | [...] |
| R3 | [...] | [...] | [...] | [...] |
مثال (ميزة نموذجية): R1. بصفتي من يشارك مستندًا، أريد أن أختار اليوم الذي يتوقف فيه الرابط عن العمل، لكي يفقد العميل الوصول حين ينتهي المشروع. إلزامي.
معايير القبول
لكل متطلب إلزامي، عمليات التحقق التي تثبت أنه يعمل. اكتبها بحيث يستطيع المختبِر، أو وكيل الذكاء الاصطناعي، تنفيذها دون أن يسألك.
| المتطلب | بافتراض | عندما | فإن |
|---|---|---|---|
| R1 | [حالة البداية] | [إجراء] | [النتيجة التي يمكن التحقق منها] |
| R1 | [...] | [...] | [...] |
المتطلبات غير الوظيفية
| المجال | المتطلب |
|---|---|
| الأداء | [...] |
| الأمان والخصوصية | [...] |
| إمكانية الوصول | [...] |
| اللغات | [...] |
| التوافق | [المتصفحات، الأجهزة، الإصدارات] |
خارج النطاق
- [ما لا يفعله هذا الإصدار، ولماذا]
- [...]
أسئلة مفتوحة
- [السؤال]، [من يجيب عنه]، [الموعد النهائي]
الملف قالب PRD/وثيقة متطلبات المنتج/03 التصميم والمسارات.md
التصميم والمسارات
اربط ملفات التصميم بدل لصقها. واحتفظ هنا بالمسار والقرارات التي تفسّره، كي لا يتناقض النص والشاشات أبدًا.
مسار المستخدم
المسار الرئيسي من حيث يبدأ المستخدم إلى ما يحصل عليه. إن لم يستطع الفريق رسمه فهو لم يُحسم بعد.
- نقطة الدخولأول إجراء
- أول إجراءاختيار أساسي
- اختيار أساسيتأكيد
- تأكيدالنتيجة
Mermaid
flowchart LR n0["نقطة الدخول"] n1["أول إجراء"] n2["اختيار أساسي"] n3["تأكيد"] n4["النتيجة"] n0 --> n1 n1 --> n2 n2 --> n3 n3 --> n4
الشاشات
| الشاشة | الغرض | رابط التصميم | الحالة |
|---|---|---|---|
| [الشاشة] | [...] | [...] | [رسم أولي، نموذج، نهائي] |
| [الشاشة] | [...] | [...] | [...] |
الحالات
لكل شاشة حالات أكثر من المسار السعيد. ضع علامة على كل حالة حين تُصمَّم، أو اكتب لماذا لا يمكن أن تحدث.
- فارغة: لا شيء لعرضه بعد
- جارٍ التحميل
- خطأ، مع ما يستطيع المستخدم فعله بعده
- لا صلاحية
- اتصال بطيء أو مقطوع
- نص طويل جدًا وأرقام كبيرة جدًا
الحالات الحدّية
| الحالة | ما يحدث |
|---|---|
| [...] | [...] |
| [...] | [...] |
مثال (ميزة نموذجية): يفتح أحدهم رابطًا بعد دقيقة من تاريخ انتهائه: فيرى أن الرابط انتهت صلاحيته ومن يسأل، ولا يرى صفحة خطأ أبدًا.
أسئلة مفتوحة
- [السؤال]، [من يجيب عنه]، [الموعد النهائي]
الملف قالب PRD/وثيقة متطلبات المنتج/04 الإطلاق والمؤشرات.md
الإطلاق والمؤشرات
مؤشر رئيسي، ومؤشران أو ثلاثة ثانوية، ومؤشر حماية: شيء يجب ألا يسوء بينما يتحسن المؤشر الرئيسي.
المؤشرات
| المؤشر | النوع | القيمة الأساسية | الهدف | طريقة القياس | تاريخ المراجعة |
|---|---|---|---|---|---|
| [...] | [رئيسي] | [...] | [...] | [...] | [التاريخ] |
| [...] | [ثانوي] | [...] | [...] | [...] | [...] |
| [...] | [حماية] | [...] | [...] | [...] | [...] |
الطرح
| المرحلة | من يحصل عليها | التاريخ | ننتقل حين |
|---|---|---|---|
| [داخلي] | [الفريق] | [...] | [...] |
| [تجريبي] | [...] | [...] | [...] |
| [الجميع] | [...] | [...] | [...] |
قائمة تحقق الإطلاق
- مقال المساعدة مكتوب
- فريق الدعم على علم
- ملاحظة الإصدار مسودة جاهزة
- أحداث التحليلات مفحوصة
- التراجع مُجرَّب
التراجع
ما الذي سيجعلك تطفئ الميزة، وكيف. قرّر ذلك قبل الإطلاق، حين لا يكون أحد متعلقًا بالنتيجة.
- نتراجع إذا: [...]
- الطريقة: [مفتاح تشغيل، إصدار، سكربت]
- من يقرر: [الاسم]
الملف قالب PRD/وثيقة متطلبات المنتج/05 القرارات والأسئلة المفتوحة.md
القرارات والأسئلة المفتوحة
حين يغيّر قرار الوثيقة، أضف سطرًا هنا وحدّث الصفحة المعنية. السجل يقول لماذا؛ والصفحة تقول ما هو صحيح الآن.
سجل القرارات
| التاريخ | القرار | صاحب القرار | السبب | الصفحة المعدّلة |
|---|---|---|---|---|
| [التاريخ] | [...] | [...] | [...] | [...] |
مثال (ميزة نموذجية): تعمل الروابط حتى نهاية آخر يوم لها في المنطقة الزمنية لمالكها، لا حتى منتصف الليل بتوقيت UTC. قررت ذلك مالكة المنتج والقائد التقني، لأن عملاء في مناطق زمنية أخرى فقدوا الوصول قبل يوم في النسخة التجريبية. الصفحة المعدّلة: المتطلبات.
أسئلة مفتوحة
| السؤال | من يجيب عنه | الموعد | الجواب |
|---|---|---|---|
| [...] | [الاسم] | [التاريخ] | [...] |
كيف تستخدمه
اكتب المشكلة قبل الحل
املأ أولًا المشكلة والأهداف وغير الأهداف في النظرة العامة مع المهندس والمصممة اللذين سيبنيان الميزة. إن لم تتفقوا ثلاثتكم على المشكلة، فتوقفوا عندها.
اجعل كل متطلب إلزامي قابلًا للاختبار
أعطِ كل متطلب إلزامي معايير قبول يستطيع شخص آخر التحقق منها. المتطلب الذي لا يستطيع أحد اختباره مجرد أمنية.
اطلب المراجعة ثم أبقِه صحيحًا
اطلب مراجعة حين تجهز المتطلبات، وحدّث الوثيقة حين يغيّرها قرار. وثيقة توقفت عند الانطلاق تصبح خاطئة يوم الإطلاق.
سجّل ما تغيّر ولماذا
يدخل كل قرار سجل القرارات مع اسم من اتخذه. وحين يسأل أحد لماذا تعمل الميزة هكذا، يكون الجواب على بُعد رابط واحد.
استورده إلى Nodary خريطةً
Nodary مساحة عمل مبنية للذكاء الاصطناعي، تترابط فيها مستندات الفريق بدل أن تتكدس. استورد ملف .zip فتصل الوثيقة وأجزاؤها الخمسة تحتها، وتبقى الروابط بين الصفحات، ويُرسم المخطط. اجعلها قيد المراجعة واطلب اعتمادها من مالك مساحة العمل أو المشروع أو من أحد مسؤوليهما، وشاهد ما تغيّر منذ زيارتك الأخيرة، ودع وكلاء الذكاء الاصطناعي المتصلين عبر MCP يقرؤون المتطلبات قبل أن يكتبوا الشيفرة.
- افتح خريطة مشروع واختر «استيراد».
- اختر تبويب «مجلد أو ZIP»، ثم «اختيار ملف ZIP».
- حدّد الملف الذي نزّلته، وتحقق من الشجرة، ثم استورد.
تتسع الخطة المجانية لعشرة مستندات في كل مساحة عمل، بما فيها صفحة المشروع نفسه: تتسع وثائق القالب الست في مساحة جديدة ويبقى مكان لثلاث أخرى. ويضم Nodary أيضًا قالبًا مدمجًا لمواصفات المنتج (PRD) في صفحة واحدة.
Nodary لفرق المنتج والتطوير
كتابة وثيقة متطلبات يستخدمها الفريق فعلًا
تفشل وثيقة المتطلبات بطريقتين: تصف حلًا لم يسائله أحد، أو يتوقف تحديثها بعد الانطلاق. هذه العادات تمنع الاثنتين.
ابدأ من المشكلة
اكتب من يعاني المشكلة وكم تكلّفه قبل أي حل. الفرق المتفقة على المشكلة تتجادل أقل حول الشاشات.
قل ما لن تفعله
غير الأهداف قرارات أيضًا. وكتابتها هي ما يمنع الميزة من أن تكبر أسبوعًا بعد أسبوع.
اجعل المتطلبات قابلة للاختبار
«سريع» و«سهل» لا يمكن التحقق منهما. أما «يتوقف الرابط عن الفتح خلال دقيقة من تاريخ انتهائه» فيمكن بناؤه واختباره.
رتّب الأولويات: إلزامي، مهم، اختياري
يصدر الإصدار حين يتحقق كل متطلب إلزامي. أما المهم والاختياري فهما ما تتنازل عنه حين يقترب الموعد.
اربط الأدلة
كل قول عن المستخدمين يربط بالمقابلة أو التذكرة أو البيانات التي يستند إليها، كي يتحقق المراجع منه بدل أن يصدّقه.
أبقِها حية
حدّث الوثيقة حين يغيّرها قرار، واكتب السبب. وفي النهاية يجب أن تصف ما صدر فعلًا، لا ما خُطط له في الأسبوع الأول.
أسئلة عن وثيقة متطلبات المنتج
ما وثيقة متطلبات المنتج (PRD)؟
وثيقة متطلبات المنتج (product requirements document أو PRD) تصف ميزة أو منتجًا قبل بنائه: المشكلة التي يحلها، ولمن هو، وما يجب أن يفعله، وكيف يُقاس النجاح، وما يقع خارج النطاق. يتولاها عادة مدير منتج، ويقرؤها المهندسون والمصممون والدعم، وعلى نحو متزايد وكلاء البرمجة بالذكاء الاصطناعي.
ماذا يجب أن تتضمن؟
على الأقل المشكلة وأدلتها، والأهداف وغير الأهداف، والمستخدمين، ومتطلبات بأولويات ومعايير قبول، والمسارات الرئيسية والحالات الحدّية، ومؤشرات النجاح، وخطة الطرح، وسجل القرارات والأسئلة المفتوحة. ولكل مجموعة في هذا القالب وثيقة.
كم يجب أن يكون طولها؟
بالقدر الذي يكفي الفريق ليبني الميزة ويختبرها دون أن يسألك السؤال نفسه مرتين. يجب أن تتسع النظرة العامة لشاشة واحدة؛ وتنمو المتطلبات مع القرارات لا مع الأفكار.
ما الفرق بينها وبين وثيقة التصميم التقني؟
وثيقة المتطلبات تقول ما يجب أن تفعله الميزة ولماذا. ووثيقة التصميم التقني تقول كيف سيفعله النظام: البنية والبيانات والواجهات والمخاطر. اكتب وثيقة المتطلبات أولًا، ثم اربط بينهما.
هل يستطيع وكلاء الذكاء الاصطناعي استخدامها؟
نعم. وثيقة متطلبات مكوّنة من مستندات مترابطة تعطي الوكيل السياق الذي يحتاجه. وفي Nodary يقرأ الوكلاء المتصلون عبر MCP، مثل Claude أو ChatGPT أو Cursor، المتطلبات وسجل القرارات بصلاحياتك قبل أن يكتبوا.
هل أستطيع استخدام القالب خارج Nodary؟
نعم. الملفات بصيغة Markdown عادية: يفتح Obsidian المجلد بعد فك ضغطه خزنةً تعمل كل روابطها، ويعرض GitHub الملفات مع مخططها. والأدوات التي تستورد Markdown ملفًا ملفًا تحتفظ بالنص والجداول؛ تحقّق من طريقة تعاملها مع الروابط بين الملفات.
أبقِ المتطلبات حيث يعمل الفريق.
استورد القالب إلى Nodary فتصبح وثيقة المتطلبات خريطة يُبقيها فريقك ووكلاء الذكاء الاصطناعي لديك محدَّثة. مجانًا لعضوين ومشروع واحد وعشرة مستندات، بلا بطاقة.