planning-with-files-ar

1# نظام تخطيط الملفات
2 
3العمل بنمط Manus: استخدام ملفات Markdown المستمرة كـ «ذاكرة عمل على القرص».
4 
5## الخطوة الأولى: استعادة حالة المشروع
6 
7**قبل المتابعة**، حدّد دليل الخطة الذي تملكه هذه المهمة:
8 
91. استخدم `scripts/resolve-plan-dir.sh` (أو `.ps1`) المثبت مع `PLAN_ID` و`PWF_PLAN_ROOT` الخاصين بالمضيف، ثم اقرأ `task_plan.md` و`progress.md` و`findings.md` من ذلك الدليل المحدد.
102. إذا رُفض محدد صريح، أو كانت عزلة الجلسة مفعلة وفيها عدة خطط بلا `PLAN_ID`، صحح التثبيت ولا ترجع إلى مهمة أخرى. استخدم ملفات جذر المشروع القديمة فقط عندما لا ينطبق محدد أو خطة مسماة.
113. نفّذ `git diff --stat` لرؤية تغييرات الكود التي قد لا تكون مسجلة بعد.
12 
13كل أسماء ملفات التخطيط التالية تعني ذلك الدليل المحدد. للمهام المتوازية، ثبّت كل مضيف قبل بدئه أو استخدم أشجار عمل منفصلة؛ تصدير متغير داخل عملية ابن لا يغير بيئة المضيف. يملك المنسق الخطة والملخصات المشتركة، ويستخدم العاملون ملفات أو دفاتر مخصصة لهم.
14 
15تنتهي الاستعادة التلقائية عند هذا الحد. لا يفحص الاستدعاء المجرد لـ `session-catchup.py` ولا خطافات دورة الحياة مخازن جلسات الوكيل. لا تستخدم أحد الوضعين التاليين إلا عندما يطلب المستخدم صراحةً الرجوع إلى سجل الجلسات المحلي:
16 
17```bash
18# Linux/macOS
19SKILL_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/skills/planning-with-files-ar}"
20# أعداد خاصة بالمشروع نفسه فقط، بلا مقتطفات من المحادثة
21$(command -v python3 || command -v python) "${SKILL_DIR}/scripts/session-catchup.py" --metadata "$(pwd)"
22 
23# إعادة تشغيل محدودة وصريحة، تصدر مقتطفات مؤطرة بقيمة nonce من المشروع نفسه
24…