AGENTS.md

هذا المستودع مصمم للعمل طويل الأمد لوكلاء البرمجة. الهدف ليس تعظيم إنتاج الكود الخام. الهدف هو ترك المستودع في حالة يمكن للجلسة التالية أن تستمر فيها بدون تخمين.

سير عمل بدء التشغيل

قبل كتابة الكود:

1. تأكد من دليل العمل باستخدام pwd.
2. اقرأ claude-progress.md لمعرفة آخر حالة مُتحقَّقة والخطوة التالية.
3. اقرأ feature_list.json واختر الميزة غير المنتهية ذات الأولوية القصوى.
4. راجع الالتزامات الأخيرة باستخدام git log --oneline -5.
5. شغّل ./init.sh.
6. شغّل الفحص أو التحقق الشامل المطلوب قبل بدء عمل جديد.

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

قواعد العمل

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

المنتجات المطلوبة

• feature_list.json: مصدر الحقيقة لحالة الميزات
• claude-progress.md: سجل الجلسة والحالة المُتحقَّقة الحالية
• init.sh: مسار بدء التشغيل والتحقق القياسي
• session-handoff.md: تسليم مضغوط اختياري للجلسات الأكبر

تعريف الإنجاز

الميزة تُعتبر منتهية فقط عندما يكون جميع ما يلي صحيحًا:

• السلوك المستهدف مُنفَّذ
• التحقق المطلوب تم تشغيله فعلًا
• الأدلة مسجلة في feature_list.json أو claude-progress.md
• المستودع يبقى قابلًا لإعادة التشغيل من مسار بدء التشغيل القياسي

نهاية الجلسة

قبل إنهاء جلسة:

1. حدِّث claude-progress.md.
2. حدِّث feature_list.json.
3. سجِّل أي خطر أو عائق غير محلول.
4. التزم برسالة وصفية بمجرد أن يكون العمل في حالة آمنة.
5. اترك المستودع نظيفًا بما يكفي لتشغيل الجلسة التالية ./init.sh فورًا.