خطوة تالية · ماذا أفعل بعد ذلك

اكتب مذكرات تسليم بسيطة ليتمكن أي شخص من تشغيل المشروع

ما قد تراه

بعد شهر سأنسى كيف يعمل

لماذا هذه الخطوة

توفر المذكرات القصيرة الصحيحة ساعات عندما تعود بعد أسابيع أو تغيّر الأدوات أو تسلّم المشروع لشخص آخر.

قبل أن تبدأ

من سيقرأ هذا: أنت أم مطور أم عضو جديد في الفريق؟

أمر هذه الخطوة

ما تكتبه هنا لا يغادر متصفحك. البحث يعمل داخل هذه الصفحة ولا يُرسل شيء إلى خادم ولا إلى ذكاء اصطناعي.

أي خطأ أو تحذير تراه الآن

ما لديك الآن (الأداة والإطار وأين يُستضاف)

يبقى في هذا المتصفح وعلى هذا الجهاز فقط. تُحذف المفاتيح وكلمات المرور قبل أي حفظ.

لغة الأمر

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

ما أريده بعد ذلك
اكتب مذكرات تسليم بسيطة ليتمكن أي شخص من تشغيل المشروع

أي خطأ أو تحذير يظهر لي الآن (اكتب "لا يوجد" إن لم يكن هناك شيء)
[الصق هنا نص الخطأ كما ظهر لك]

ما لدي الآن (الأداة التي استخدمتها، والإطار، وأين يُستضاف)
[اكتب بإيجاز ما فعلته قبل ظهور المشكلة]

لماذا هذه الخطوة
توفر المذكرات القصيرة الصحيحة ساعات عندما تعود بعد أسابيع أو تغيّر الأدوات أو تسلّم المشروع لشخص آخر.

نفّذ هذه الخطوات بهذا الترتيب
1. اقرأ المشروع واكتب README في أقل من صفحتين: ما هو وكيف يعمل والمجلدات والأوامر (تطوير وبناء واختبار) وقائمة أسماء متغيرات البيئة مع غرض كل منها وكيف يُنشر.
2. أضف قائمة "كيف" لأكثر خمس مهام شيوعاً (تغيير نص وإضافة منتج وإضافة لغة وتدوير مفتاح واستعادة نسخة) وصفحة "عندما ينكسر شيء" بأول ثلاثة فحوص.
3. تحقق باتباع المذكرات بنفسك في مجلد نظيف وأصلح كل خطوة تفشل.
توقف وأخبرني إذا كان ما تراه لا يطابق إحدى الخطوات. لا تتجاوز أي خطوة.

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

لا تغيّر
- لا تكتب أسراراً في المذكرات.
- أي شيء لم أطلبه: التصميم أو النصوص أو الصفحات الأخرى أو الإعدادات الأخرى أو البيانات.
- لا تحذف ملفات أو بيانات أو فروعاً، ولا تعِد الضبط ولا تدفع بالقوة (force push)، ولا تعيد كتابة السجل، إلا بعد أن تعرض عليّ بالضبط ما الذي سيضيع وأوافق.
- لا تلصق ولا تطبع ولا تطلب مني لصق كلمة مرور أو مفتاح سري في هذه المحادثة. وإذا لزم أحدها فأخبرني في أي صفحة إعدادات من الخدمة الصحيحة أحفظه.

عند الانتهاء
اشرح بكلمات بسيطة ما الذي غيّرته (ملفاً ملفاً أو إعداداً إعداداً) ولماذا غيّرته وكيف أتراجع عنه.

الصقه في Claude أو ChatGPT أو Gemini أو Cursor ثم اتبع ما يقوله.

بعد أن جرّبته، هل نجح؟

الخطوات

اقرأ المشروع واكتب README في أقل من صفحتين: ما هو وكيف يعمل والمجلدات والأوامر (تطوير وبناء واختبار) وقائمة أسماء متغيرات البيئة مع غرض كل منها وكيف يُنشر.
أضف قائمة "كيف" لأكثر خمس مهام شيوعاً (تغيير نص وإضافة منتج وإضافة لغة وتدوير مفتاح واستعادة نسخة) وصفحة "عندما ينكسر شيء" بأول ثلاثة فحوص.
تحقق باتباع المذكرات بنفسك في مجلد نظيف وأصلح كل خطوة تفشل.

لا تفعل هذا

لا تصف ما تتمنى أنه صحيح؛ اختبر كل خطوة.
لا تكتب أسراراً في المذكرات.