خطة المهمة: [وصف مختصر]

<!-- ماذا: هذه خارطة طريقك للمهمة بأكملها. فكر فيها كـ "ذاكرتك العاملة على القرص". لماذا: بعد أكثر من 50 استدعاء أداة، قد تُنسى أهدافك الأصلية. هذا الملف يبقيها حاضرة. متى: أنشئ هذا أولاً، قبل بدء أي عمل. حدّث بعد إكمال كل مرحلة. -->

الهدف

<!-- ماذا: جملة واحدة واضحة تصف ما تحاول تحقيقه. لماذا: هذا نجمك القطبي. إعادة قراءته تبقيك مركزاً على الحالة النهائية. مثال: "إنشاء تطبيق مهام يومية بواجهة سطر أوامر بلغة بايثون مع وظائف الإضافة والعرض والحذف." -->

[جملة واحدة تصف الحالة النهائية]

المرحلة الحالية

<!-- ماذا: أي مرحلة تعمل عليها حالياً (مثلاً "المرحلة 1"، "المرحلة 3"). لماذا: مرجع سريع لمكانك في المهمة. حدّث هذا أثناء تقدمك. -->

المرحلة 1

المراحل

<!-- ماذا: قسّم مهمتك إلى 3-7 مراحل منطقية. يجب أن تكون كل مرحلة قابلة للإكمال. لماذا: تقسيم العمل إلى مراحل يمنع الإرهاق ويجعل التقدم مرئياً. متى: حدّث الحالة بعد إكمال كل مرحلة: pending → in_progress → complete -->

المرحلة 1: المتطلبات والاكتشاف

<!-- ماذا: افهم ما يجب القيام به واجمع المعلومات الأولية. لماذا: البدء بدون فهم يؤدي إلى جهد ضائع. هذه المرحلة تمنع ذلك. -->

• فهم نية المستخدم
• تحديد القيود والمتطلبات
• توثيق النتائج في findings.md
• الحالة: in_progress

<!-- قيم الحالة: - pending: لم يبدأ بعد - in_progress: يعمل عليه حالياً - complete: أُكملت هذه المرحلة -->

المرحلة 2: التخطيط والهيكلة

<!-- ماذا: قرر كيف ستعالج المشكلة وما الهيكل الذي ستستخدمه. لماذا: التخطيط الجيد يمنع إعادة العمل. وثّق القرارات لتتذكر لماذا اخترتها. -->

• تحديد المنهج التقني
• إنشاء هيكل المشروع إذا لزم الأمر
• توثيق القرارات مع مبرراتها
• الحالة: pending

المرحلة 3: التنفيذ

<!-- ماذا: بناء/إنشاء/كتابة الحل فعلياً. لماذا: هنا يحدث العمل. قسّم إلى مهام فرعية أصغر إذا لزم الأمر. -->

• تنفيذ الخطة خطوة بخطوة
• كتابة التعليمات البرمجية إلى الملفات قبل التنفيذ
• الاختبار بشكل تدريجي
• الحالة: pending

المرحلة 4: الاختبار والتحقق

<!-- ماذا: تحقق أن كل شيء يعمل ويحقق المتطلبات. لماذا: اكتشاف المشاكل مبكراً يوفر الوقت. وثّق نتائج الاختبار في progress.md. -->

• التحقق من تحقيق جميع المتطلبات
• توثيق نتائج الاختبار في progress.md
• إصلاح أي مشاكل تم اكتشافها
• الحالة: pending

المرحلة 5: التسليم

<!-- ماذا: المراجعة النهائية والتسليم للمستخدم. لماذا: يضمن عدم نسيان أي شيء واكتمال المخرجات. -->

• مراجعة جميع ملفات المخرجات
• التأكد من اكتمال المخرجات
• التسليم للمستخدم
• الحالة: pending

الأسئلة الرئيسية

<!-- ماذا: أسئلة مهمة تحتاج للإجابة عليها أثناء المهمة. لماذا: هذه توجه بحثك واتخاذ قراراتك. أجب عنها أثناء سير العمل. مثال: 1. هل يجب أن تستمر المهام بين الجلسات؟ (نعم - يحتاج تخزين ملفات) 2. ما صيغة تخزين المهام؟ (ملف JSON) -->

1. [سؤال للإجابة عليه]
2. [سؤال للإجابة عليه]

القرارات المتخذة

<!-- ماذا: القرارات التقنية والتصميمية التي اتخذتها، مع أسبابها. لماذا: ستنسى لماذا اتخذت خياراتك. هذا الجدول يساعدك على التذكر وتبرير القرارات. متى: حدّث كلما اتخذت خياراً مهماً (تقنية، منهج، هيكل). مثال: | استخدام JSON للتخزين | بسيط، مقروء بشرياً، دعم مدمج في بايثون | -->

القرار	المبرر

الأخطاء التي تمت مواجهتها

<!-- ماذا: كل خطأ واجهته، ما رقم المحاولة، وكيف حللته. لماذا: تسجيل الأخطاء يمنع تكرار نفس الأخطاء. هذا أمر بالغ الأهمية للتعلم. متى: أضف فوراً عند حدوث خطأ، حتى لو أصلحته بسرعة. مثال: | FileNotFoundError | 1 | التحقق من وجود الملف، إنشاء قائمة فارغة إذا لم يوجد | | JSONDecodeError | 2 | معالجة حالة الملف الفارغ بشكل صريح | -->

الخطأ	المحاولة	الحل
	1

ملاحظات

<!-- تذكيرات: - حدّث حالة المرحلة أثناء تقدمك: pending → in_progress → complete - أعد قراءة هذه الخطة قبل القرارات الرئيسية (توجيه الانتباه) - سجّل جميع الأخطاء - فهي تساعد في تجنب التكرار - لا تكرر إجراءً فاشلاً - غيّر منهجك بدلاً من ذلك -->

• حدّث حالة المرحلة أثناء تقدمك: pending → in_progress → complete
• أعد قراءة هذه الخطة قبل القرارات الرئيسية (توجيه الانتباه)
• سجّل جميع الأخطاء - فهي تساعد في تجنب التكرار