من المواصفات إلى النسخة الأولى

This content is not available in your language yet.

لكل مشروع في حسنات ملفان في مجلده في مستودع hasanat-dev/projects:

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

الموجز يُنشر على hasanat.dev. المواصفات الكاملة تبقى في المستودع الخاص، ويصل إليها الفريق.

1. من الفكرة إلى مسودة مواصفات

تُقترح الأفكار ويُصوَّت لها على hasanat.dev. الفكرة تجمع الحاجة والتأييد فقط.
يختار اللقاء الشهري بعض الأفكار لتُكتب مواصفاتها.
يستطيع أي شخص أن يكتب مسودة: انسخ القالب، واكتب الموجز والمواصفات بمساعدة وكيل برمجة، ثم أرسلهما طلب سحب (pull request) إلى المستودع.
المستودع خاص. إن لم تكن لديك صلاحية الوصول إليه، اطلبها في مجموعة البنّائين.
يعتمد اللقاء الشهري بعض المسودات، فتظهر في hasanat.dev.

2. من المواصفات إلى قائد

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

3. تكوين الفريق

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

4. بناء النسخة الأولى

المواصفات هي المرجع في النطاق والقرارات:

ابدأ مما هو موجود (القسم 4): أعد استخدام الكود والبيانات والوثائق قبل أن تبني شيئًا جديدًا.
ابنِ ما في القسم 5 «النسخة الأولى» فقط، وافحص معايير قبوله.
اعتبر القسم 6 «نؤجّله لمراحل لاحقة» خارج النطاق، ومنه الإضافات «السريعة».
لا تفترض إجابة عن «الأسئلة المفتوحة» (القسم 11): اسأل القائد. إن لم يحتمل العمل الانتظار، اختر أصغر خيار يمكن التراجع عنه، واذكر افتراضك.
تبدأ المشاريع الجديدة من قالب حسنات. وتبقى المشاريع القائمة على تقنيتها ومستودعها.
اقترح أي تغيير في المواصفات طلبَ سحب إلى مستودع المشاريع، ليراجعه القائد.

في القسم 12 من كل مواصفات رسالة جاهزة لوكيل البرمجة. هذه رسالة القالب:

اقرأ AGENTS.md في جذر المستودع، ثم brief.md وspec.md في مجلد المشروع.
ابنِ «النسخة الأولى» فقط، والتزم «نؤجّله لمراحل لاحقة».
لا تفترض إجابة لأي «سؤال مفتوح»: اسألني أولًا.
ابدأ بخطة قصيرة، ثم بخطوة صغيرة واحدة يمكن فحصها في المتصفح.

5. من «قيد البناء» إلى «يعمل»

الهدف تجربة مع مستخدمين حقيقيين (القسم 7)، لا موقع منشور فقط. انظر أدر تجربة.
حين تتمّ التجربة، ينقل القائد المشروع إلى «يعمل» ويضبط رابط المنتج.
بعد ذلك تذهب طلبات الميزات إلى مهامّ المشروع على GitHub.