# Planning With Files Ar

تخطيط مستمر قائم على الملفات لعمل وكلاء الذكاء الاصطناعي متعدد الخطوات.

- Repository: https://github.com/OthmanAdi/planning-with-files (27809 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-30
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add OthmanAdi/planning-with-files --skill planning-with-files-ar -g -a claude-code -y`
Codex: `npx skills add OthmanAdi/planning-with-files --skill planning-with-files-ar -g -a codex -y`
Cursor: `npx skills add OthmanAdi/planning-with-files --skill planning-with-files-ar -g -a cursor -y`
Gemini CLI: `npx skills add OthmanAdi/planning-with-files --skill planning-with-files-ar -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add OthmanAdi/planning-with-files`

## Description

تخطيط مستمر قائم على الملفات لعمل وكلاء الذكاء الاصطناعي متعدد الخطوات. يحتفظ بملفات task_plan.md و findings.md و progress.md على القرص، وتحقن خطافات دورة الحياة سياق التخطيط المحدد للمشروع. تقرأ الاستعادة التلقائية ملفات تخطيط المشروع فقط. يمكن للأمر الصريح session-catchup.py --metadata فحص بيانات وصفية لجلسات الوكيل المحلية التابعة للمشروع نفسه، بينما قد يصدر --replay مقتطفات محدودة مؤطرة بقيمة nonce. يمكن للوضع المحكوم الاختياري طلب المتابعة فقط عندما يدعمه المضيف، ولا ينفذ أبدًا أوامر معلنة في Markdown. لا تتضمن المهارة مسارًا لرفع البيانات عبر الشبكة. تُستخدم للبحث أو العمل الذي يحتاج إلى 5 استدعاءات أدوات أو أكثر.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

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

العمل بنمط Manus: استخدام ملفات Markdown المستمرة كـ «ذاكرة عمل على القرص».

## الخطوة الأولى: استعادة حالة المشروع

**قبل المتابعة**، حدّد دليل الخطة الذي تملكه هذه المهمة:

1. استخدم `scripts/resolve-plan-dir.sh` (أو `.ps1`) المثبت مع `PLAN_ID` و`PWF_PLAN_ROOT` الخاصين بالمضيف، ثم اقرأ `task_plan.md` و`progress.md` و`findings.md` من ذلك الدليل المحدد.
2. إذا رُفض محدد صريح، أو كانت عزلة الجلسة مفعلة وفيها عدة خطط بلا `PLAN_ID`، صحح التثبيت ولا ترجع إلى مهمة أخرى. استخدم ملفات جذر المشروع القديمة فقط عندما لا ينطبق محدد أو خطة مسماة.
3. نفّذ `git diff --stat` لرؤية تغييرات الكود التي قد لا تكون مسجلة بعد.

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

تنتهي الاستعادة التلقائية عند هذا الحد. لا يفحص الاستدعاء المجرد لـ `session-catchup.py` ولا خطافات دورة الحياة مخازن جلسات الوكيل. لا تستخدم أحد الوضعين التاليين إلا عندما يطلب المستخدم صراحةً الرجوع إلى سجل الجلسات المحلي:

```bash
# Linux/macOS
SKILL_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/skills/planning-with-files-ar}"
# أعداد خاصة بالمشروع نفسه فقط، بلا مقتطفات من المحادثة
$(command -v python3 || command -v python) "${SKILL_DIR}/scripts/session-catchup.py" --metadata "$(pwd)"

# إعادة تشغيل محدودة وصريحة، تصدر مقتطفات مؤطرة بقيمة nonce من المشروع نفسه
$(command -v python3 || command -v python) "${SKILL_DIR}/scripts/session-catchup.py" --replay "$(pwd)"
```

```powershell
# Windows PowerShell
& (Get-Command python -ErrorAction SilentlyContinue).Source "$env:USERPROFILE\.claude\skills\planning-with-files-ar\scripts\session-catchup.py" --metadata (Get-Location)
# استبدل --metadata بـ --replay فقط بعد موافقة المستخدم الصريحة.
```

The rest: https://github.com/OthmanAdi/planning-with-files/blob/HEAD/skills/i18n/planning-with-files-ar/SKILL.md