نظام تخطيط الملفات

الخطوة الأولى: استعادة السياق (v2.2.0)

1. إذا كان

   task_plan.md

   موجودًا، اقرأ فورًا

   task_plan.md

   و

   progress.md

   و

   findings.md

   .
2. ثم تحقق مما إذا كانت الجلسة السابقة تحتوي على سياق غير متزامن:

# Linux/macOS
$(command -v python3 || command -v python) ${CLAUDE_PLUGIN_ROOT}/scripts/session-catchup.py "$(pwd)"

# Windows PowerShell
& (Get-Command python -ErrorAction SilentlyContinue).Source "$env:USERPROFILE\.claude\skills\planning-with-files-ar\scripts\session-catchup.py" (Get-Location)

1. نفذ

   git diff --stat

   لرؤية تغييرات الكود الفعلية
2. اقرأ ملفات التخطيط الحالية
3. حدّث ملفات التخطيط بناءً على تقرير الاستعادة و git diff
4. ثم تابع المهمة

مهم: موقع تخزين الملفات

• القوالب موجودة في

  ${CLAUDE_PLUGIN_ROOT}/templates/

• ملفات التخطيط الخاصة بك توضع في دليل مشروعك

${CLAUDE_PLUGIN_ROOT}/

task_plan.md

findings.md

progress.md

البدء السريع

1. أنشئ

   task_plan.md

   — راجع قالب templates/task_plan.md
2. أنشئ

   findings.md

   — راجع قالب templates/findings.md
3. أنشئ

   progress.md

   — راجع قالب templates/progress.md
4. أعد قراءة الخطة قبل القرارات — حدّث الأهداف في نافذة الانتباه
5. حدّث بعد كل مرحلة — علّم المكتمل، سجّل الأخطاء

ملاحظة: ملفات التخطيط توضع في جذر مشروعك، وليس في دليل تثبيت المهارة.

النمط الأساسي

نافذة السياق = الذاكرة (متقلبة، محدودة)
نظام الملفات = القرص (مستمر، غير محدود)

→ أي محتوى مهم يُكتب على القرص.

الغرض من الملفات

task_plan.md

findings.md

progress.md

القواعد الأساسية

1. أنشئ الخطة أولاً

task_plan.md

2. قاعدة الخطوتين

"بعد كل عمليتي بحث/تصفح، احفظ الاكتشافات المهمة فورًا في ملف."

3. اقرأ قبل القرار

4. حدّث بعد العمل

• علّم حالة المرحلة:

  in_progress

  →

  complete

• سجّل أي أخطاء واجهتك
• دوّن الملفات التي تم إنشاؤها/تعديلها

5. سجّل جميع الأخطاء

## الأخطاء التي تمت مواجهتها
| الخطأ | عدد المحاولات | الحل |
|------|---------|---------|
| FileNotFoundError | 1 | تم إنشاء إعداد افتراضي |
| انتهاء مهلة API | 2 | تمت إضافة منطق إعادة المحاولة |

6. لا تكرر الفشل أبدًا

if فشل العملية:
    الخطوة التالية != نفس العملية

7. تابع بعد الاكتمال

• أضف مراحل في

  task_plan.md

  (مثل المرحلة 6، المرحلة 7)
• سجّل إدخال جلسة جديد في

  progress.md

• تابع سير العمل المخطط كالمعتاد

بروتوكول الفشل الثلاثي

المحاولة 1: التشخيص والإصلاح
  → اقرأ الخطأ بعناية
  → اعثر على السبب الجذري
  → إصلاح مستهدف

المحاولة 2: نهج بديل
  → نفس الخطأ؟ جرّب طريقة مختلفة
  → أداة مختلفة؟ مكتبة مختلفة؟
  → لا تكرر أبدًا نفس الفشل تمامًا

المحاولة 3: إعادة التفكير
  → شكّك في الافتراضات
  → ابحث عن حلول
  → فكّر في تحديث الخطة

بعد 3 فشل: اطلب من المستخدم
  → اشرح ما جربته
  → شارك الخطأ المحدد
  → اطلب التوجيه

مصفوفة قرار القراءة vs الكتابة

اختبار إعادة التشغيل بخمسة أسئلة

متى تستخدم هذا النمط

• مهام متعددة الخطوات (أكثر من 3 خطوات)
• مهام البحث
• بناء/إنشاء مشاريع
• مهام تمتد عبر استدعاءات أدوات متعددة
• أي عمل يحتاج تنظيمًا

• أسئلة بسيطة
• تعديل ملف واحد
• استعلامات سريعة

القوالب

• templates/task_plan.md — تتبع المراحل
• templates/findings.md — تخزين البحث
• templates/progress.md — سجل الجلسة

النصوص البرمجية

• scripts/init-session.sh

  — تهيئة جميع ملفات التخطيط

• scripts/check-complete.sh

  — التحقق من اكتمال جميع المراحل

• scripts/session-catchup.py

  — استعادة السياق من الجلسة السابقة (v2.2.0)

الحدود الأمنية

task_plan.md

task_plan.md

findings.md

task_plan.md

الأنماط المضادة