ترحيل السياق

# برومبت حفظ السياق وترحيله

[في ملف AGENT.MD، تجاوز أي قسم `## SECTION` إذا لم يكن منطبقاً]

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

## الأهداف الأساسية

التقط ونظّم كل عناصر السياق من الجلسة الحالية لتمكين:
1. **استمرارية الجلسة** - استكمال المحادثة عبر منصات ذكاء اصطناعي مختلفة بدون إعادة شرح
2. **تسليم العمل بين الوكلاء** - نقل المهام غير المكتملة إلى وكلاء جدد مع توثيق كامل للتقدم
3. **ترحيل المشروع** - إعادة بناء ثقافة العمل في المشروع، وسير العمل، وهياكل الحوكمة بالكامل

## فئات المحتوى المطلوب حفظها

### سياق المحادثة
- المتطلبات الأولية وقصص المستخدم التي تطورت أثناء النقاش
- الأفكار التي ظهرت خلال جلسات العصف الذهني
- القرارات المتخذة مع التسلسل المنطقي والمسوغات خلفها
- الاتفاقات التي تم الوصول إليها وحالة اعتمادها أو التحقق منها
- الاقتراحات والتوصيات مع السياق الداعم لها
- الافتراضات التي تم تثبيتها وحالتها الحالية
- الرؤى المهمة ولحظات التحول أو الاكتشاف
- النقاط المحورية التي تُعد أساساً بنيوياً للعمل

### توثيق التقدم
- الحالة الحالية لكل مسار عمل
- المهام والمخرجات المكتملة
- البنود المعلقة والخطوات التالية
- العوائق التي ظهرت مع استراتيجيات التعامل معها
- حدود المعدل أو الطلبات التي تم الوصول إليها، وحلول الالتفاف المعتمدة
- تسلسل زمني لأهم المحطات والإنجازات

### بنية المشروع، عند الانطباق
- منهجية SDLC والمراحل المعتمدة
- منظومة الوكلاء: وكلاء رئيسيون، وكلاء فرعيون، وكلاء شقيقون، وكلاء مراقبون
- القواعد، وسياسات الحوكمة، والاستراتيجيات
- هياكل المستودع مثل .github workflows والقوالب
- قوالب برومبت قابلة لإعادة الاستخدام مثل تفكيك الـ epic، وPRD، والخطط المعمارية، وتصميم النظام
- الأنماط المتفق عليها مثل صيغ الـ commit، وبرومبتات الذاكرة، وهياكل السجلات
- تسلسل التعليمات الهرمي: مستوى المشروع، مستوى السبرنت، مستوى الـ epic، والاختلافات بينها
- إعدادات CI/CD مثل الاختبار، والتنسيق، واستخراج commits
- تنسيق العمل بين عدة وكلاء مثل prompt chaining، وparallelization، وrouter agents
- معايير تنسيقات المخرجات والاختلافات المعتمدة

### القواعد والبروتوكولات
- الإرشادات المتفق عليها مع تحديد نطاق كل قاعدة
- التعليمات الإضافية التي تمت إضافتها أثناء الجلسة
- القيود والحدود التي تم وضعها
- معايير الجودة ومعايير القبول
- آليات المواءمة التي تحافظ على مسار العمل الصحيح

# الخطوات

1. **راجع سجل المحادثة بالكامل** - افحص كل التفاعلات في الثريد أو الجلسة الحالية لاستخراج السياق الكامل
2. **استخرج العناصر الأساسية** - حدّد وصنّف المعلومات حسب فئات المحتوى أعلاه
3. **وثّق حالة التقدم** - سجّل ما تم إنجازه، وما هو قيد التنفيذ، وما هو معلّق
4. **احفظ تسلسل القرارات** - اذكر أسباب كل اختيار مهم والمنطق الذي قاد إليه
5. **نظّم الوثيقة لتكون قابلة للنقل** - استخدم صيغة واضحة يمكن لأي منصة أو وكيل فهمها
6. **أضف تعليمات التسليم** - ضمّن إرشادات مباشرة للذكاء الاصطناعي أو الوكيل أو الجلسة التالية

# تنسيق المخرجات

أنتج مستند Markdown منظماً يحتوي على الأقسام التالية:

```
# وثيقة السياق: [عنوان الجلسة/المشروع]
**تم الإنشاء**: [التاريخ/الوقت]
**منصة المصدر**: [اسم منصة الذكاء الاصطناعي]
**أولوية الاستكمال**: [حرجة/عالية/متوسطة/منخفضة]

## نظرة عامة على الجلسة
[ملخص من 2-3 جمل يوضح الهدف الأساسي والحالة الحالية]

## السياق الأساسي
### المتطلبات الأصلية
[طلبات المستخدم وأهدافه الأولية]

### التطور والقرارات
[أهم القرارات المتخذة مع أسبابها - على شكل نقاط]

### التقدم الحالي
- مكتمل: [قائمة]
- قيد التنفيذ: [قائمة مع نسبة الإنجاز]
- معلّق: [قائمة]
- متعثر: [قائمة مع العوائق وخطط التعامل معها]

## قاعدة المعرفة
### أهم الرؤى والاتفاقات
[الاكتشافات المهمة ونقاط الاتفاق]

### القواعد والبروتوكولات المعتمدة
[الإرشادات، القيود، والمعايير التي تم تحديدها خلال الجلسة]

### الافتراضات والتحقق
[ما تم افتراضه وحالة التحقق منه]

## الأصول والمخرجات
[قائمة الملفات، أو المستندات، أو الأكواد التي تم إنشاؤها مع وصفها]

## هيكل المشروع، عند الانطباق
### نظرة عامة على المعمارية
[SDLC، سير العمل، وهيكل المستودع]

### منظومة الوكلاء
[وصف الوكلاء، وأدوارهم، وطريقة تفاعلهم]

### المكونات القابلة لإعادة الاستخدام
[قوالب البرومبت، وسير العمل، وسكربتات الأتمتة]

### الحوكمة والمعايير
[تسلسل التعليمات، والأنماط المتفق عليها، وبوابات الجودة]

## تعليمات التسليم
### للجلسة أو الوكيل التالي
[خطوات صريحة لاستكمال العمل]

### السياق الذي يجب التركيز عليه
[ما يجب أن يفهمه الذكاء الاصطناعي التالي فوراً]

### التحديات المحتملة
[المشكلات المعروفة والطريقة الموصى بها للتعامل معها]

## برومبت الاستكمال
[برومبت مقترح للذكاء الاصطناعي التالي: «بناءً على وثيقة السياق هذه، كمل العمل عبر...»]
```

# أمثلة

**مثال 1: استمرارية جلسة، تسليم عصف ذهني**

المدخل: «كنا نعصف ذهنياً لمدة ساعتين حول تطبيق جوال. أحتاج أنقل العمل إلى Claude. أنشئ وثيقة سياق.»

المخرج:
```
# وثيقة السياق: تخطيط تطبيق نشاطي برو للجوال
**تم الإنشاء**: 2026-01-07 14:30
**منصة المصدر**: Google Gemini
**أولوية الاستكمال**: عالية

## نظرة عامة على الجلسة
تم تنفيذ عصف ذهني لتطبيق تتبع لياقة موجّه للموظفين ورواد الأعمال المشغولين في السوق السعودي. تم الاتفاق على تصميم بسيط مع مدرب ذكي بالذكاء الاصطناعي. المشروع جاهز الآن للانتقال إلى مرحلة المعمارية التقنية.

## السياق الأساسي
### المتطلبات الأصلية
- الفئة المستهدفة: مهنيون وموظفون من عمر 25-40، وقتهم محدود للذهاب للنادي
- يجب أن يتزامن مع Apple Watch و Fitbit
- الميزانية: 180,000 ريال سعودي للـ MVP
- الجدول الزمني: 3 أشهر للإطلاق

### التطور والقرارات
- ✓ الاسم: «نشاطي برو»؛ تم استبعاد «تمرينك» و«ربع ساعة»
- ✓ الميزة الأساسية: تمارين مخصصة بالذكاء الاصطناعي لمدة 15 دقيقة، وليست خططاً عامة
- ✓ نموذج الربح: Freemium مع اشتراك مميز بقيمة 35 ريال شهرياً
- ✓ التقنية: React Native لإطلاق iOS و Android في نفس الوقت

### التقدم الحالي
- مكتمل: ترتيب أولويات الميزات، شخصيات المستخدم، نموذج الربح
- قيد التنفيذ: لا يوجد حالياً
- معلّق: المعمارية التقنية، مخطط قاعدة البيانات، تصميم API
- متعثر: لا يوجد

## قاعدة المعرفة
### أهم الرؤى والاتفاقات
- المستخدمون يفضلون «ذكي ومختصر» على «طويل وشامل»؛ الاختصار هنا ميزة مدفوعة وليست نقصاً
- المدرب الذكي لازم يكون أسلوبه حوارياً ومسانداً، وليس أوامر جامدة
- الميزات الاجتماعية مؤجلة للإصدار الثاني لتجنب تضخم النطاق

(... تُستكمل بقية الأقسام بنفس الهيكل)

## برومبت الاستكمال
«بناءً على وثيقة السياق الخاصة بتخطيط تطبيق نشاطي برو، صمّم المعمارية التقنية وتشمل مخطط قاعدة البيانات، ونقاط API، واستراتيجية التكامل مع Apple Watch و Fitbit.»
```

**مثال 2: تسليم وكيل، أتمتة توقفت بسبب حد الطلبات**

المدخل: «وكيل المتصفح وصل حد الطلبات وهو يجمع أسعار المنافسين. أنشئ مستند تسليم.»

المخرج:
```
# وثيقة السياق: أتمتة جمع أسعار المنافسين، غير مكتملة
**تم الإنشاء**: 2026-01-07 09:15
**منصة المصدر**: Browser Agent v2.1
**أولوية الاستكمال**: حرجة

## نظرة عامة على الجلسة
تم تشغيل أتمتة لجمع الأسعار من 50 متجراً إلكترونياً لمقارنة أسعار السماعات اللاسلكية. اكتمل 32 من 50 موقعاً قبل الوصول إلى حدود الطلبات. يلزم الاستكمال مباشرة للالتزام بموعد التسليم يوم الجمعة.

## السياق الأساسي
### المتطلبات الأصلية
- جمع أسعار «سماعات لاسلكية أقل من 400 ريال» من 50 متجراً إلكترونياً محلياً وإقليمياً
- استخراج: اسم المنتج، السعر، التقييم، عدد المراجعات
- المخرج المطلوب: ملف CSV واحد للتحليل
- الموعد النهائي: الجمعة 5 مساءً

### التطور والقرارات
- ✓ تمت إضافة منطق إعادة المحاولة بعد فشل أولي في المواقع كثيفة JavaScript
- ✓ تم التحول إلى headless Chrome بدلاً من requests library لتحسين التوافق
- ✓ تم اعتماد تأخير 3 ثوانٍ بين الطلبات لكل نطاق
- ✓ أضاف المستخدم تعليمات: «تجاوز المواقع التي تتطلب تسجيل دخول»

### التقدم الحالي
- مكتمل: تم جمع البيانات من 32/50 موقعاً بنجاح، بإجمالي 2,847 منتجاً
- قيد التنفيذ: لا يوجد؛ تم التوقف بسبب حد الطلبات
- معلّق: 18 موقعاً متبقياً، والقائمة موجودة في برومبت الاستكمال أدناه
- متعثر: تم الوصول لحد الطلبات في النطاقات amazon.sa و noon.com و jarir.com، وتحتاج فترة تهدئة ساعتين

## قاعدة المعرفة
### القواعد والبروتوكولات المعتمدة
- الالتزام بملف robots.txt بدون استثناء
- حد أقصى طلب واحد كل 3 ثوانٍ لكل نطاق
- تجاهل المنتجات التي لا تحتوي على مراجعات لتقليل الضجيج في البيانات
- التعامل مع التصفح بين الصفحات حتى 5 صفحات كحد أقصى لكل موقع

### التحديات وخطط التعامل
- التحدي: الأسعار الديناميكية التي قد تتغير أثناء الجمع
  خطة التعامل: إضافة timestamp لكل سجل
- التحدي: ظهور CAPTCHAs في 3 مواقع
  خطة التعامل: وافق المستخدم على إدخال يدوي لهذه المواقع الثلاثة
- التحدي: حدود الطلبات
  خطة التعامل: استخدام exponential backoff وتدوير user agents

## برومبت الاستكمال
«أكمل أتمتة جمع الأسعار. المواقع المتبقية 18: [extra.com, xcite.com, microless.com...]. استخدم الملف الحالي pricing_data_partial.csv وفيه 2,847 سجل. النطاقات التي وصلت حد الطلبات تحتاج انتظار ساعتين. ابدأ بالمواقع غير المتعثرة أولاً. طبّق كل القواعد المعتمدة: تأخير 3 ثوانٍ، تجاهل المنتجات بلا مراجعات، حد 5 صفحات لكل موقع. سلّم ملف CSV النهائي قبل الجمعة 5 مساءً.»
```

**مثال 3: ترحيل مشروع، نقل ثقافة المشروع بالكامل**

(سياق الإدخال: مستودع مشروع كامل يحتوي على SDLC، ووكلاء، وحوكمة)

المخرج: *(مثال مختصر يوضح الهيكل؛ المخرج الحقيقي يجب أن يكون شاملاً)*
```
# وثيقة السياق: ثقافة ومعمارية مشروع SmartInventory
**تم الإنشاء**: 2026-01-07 16:00
**منصة المصدر**: GitHub Copilot + Multi-Agent System
**أولوية الاستكمال**: متوسطة، لغرض تهيئة إطار وكلاء ذكاء اصطناعي جديد

## نظرة عامة على الجلسة
نظام إدارة مخزون للمنشآت يستخدم ثقافة تطوير مدفوعة بالذكاء الاصطناعي. المطلوب إعادة بناء هيكل المشروع، ومنظومة الوكلاء، والحوكمة ضمن إعداد جديد لوكلاء ذكاء اصطناعي مستقلين.

## هيكل المشروع
### إطار SDLC
- المنهجية: Agile مع سبرنتات لمدة أسبوعين
- المراحل: تخطيط Epic → تطوير → مراجعة المراقب → CI/CD → نشر
- كل الإجراءات مدفوعة بالذكاء الاصطناعي: توليد الكود، الاختبار، التوثيق، وتوليد سردية commits

### منظومة الوكلاء
**الوكلاء الرئيسيون:**
- DevAgent: توليد الكود والتنفيذ
- TestAgent: الاختبارات الآلية وضمان الجودة
- DocAgent: إنشاء التوثيق وتحديثه

**وكيل المراقبة، حارس المشروع:**
- الدور: فرض المواءمة بين كل الوكلاء
- الوظائف: ملاحظات PR، التحقق من المسارات، الالتزام بالمعايير
- المشغل: كل commit و PR وإغلاق epic

**وكلاء CI/CD:**
- FormatterAgent: فرض تنسيق الكود
- ReflectionAgent: استخراج commits وتحويلها إلى reflections منظمة، وقصص تطوير، ومخرجات سردية
- DeployAgent: خطوط نشر آلية

**الوكلاء الفرعيون حسب نطاق الميزة:**
- InventorySubAgent, UserAuthSubAgent, ReportingSubAgent

**التنسيق:**
- تنسيق متعدد الوكلاء عبر دفاتر .ipynb
- الأنماط: Prompt chaining، Parallelization، Router agents

### هيكل المستودع .github
```
.github/
├── workflows/
│   ├── epic_breakdown.yml
│   ├── epic_generator.yml
│   ├── prd_template.yml
│   ├── architectural_plan.yml
│   ├── system_design.yml
│   ├── conventional_commit.yml
│   ├── memory_prompt.yml
│   └── log_prompt.yml
├── AGENTS.md (سجل الوكلاء)
├── copilot-instructions.md (قواعد مستوى المشروع)
└── sprints/
    ├── sprint_01_instructions.md
    └── epic_variations/
```

### الحوكمة والمعايير
**تسلسل التعليمات الهرمي:**
1. `copilot-instructions.md` - قواعد ثابتة على مستوى المشروع
2. تعليمات السبرنت - تغييرات زمنية حسب السبرنت
3. تعليمات الـ epic - استدعاءات مرتبطة بهدف محدد

**الأنماط المتفق عليها:**
- Commits: صيغة `type(scope): description` حسب معيار Conventional Commits
- برومبت الذاكرة: قالب حفظ حالة الجلسة
- برومبت السجل: صيغة منظمة لتتبع النشاط

(... تُستكمل الأقسام: المكونات القابلة لإعادة الاستخدام، بوابات الجودة، وتعليمات الاستكمال لإعادة البناء مع وكلاء الذكاء الاصطناعي الجدد...)
```

# ملاحظات

- **الشمولية**: لازم يكون الهيكل مفهوماً لأي منصة ذكاء اصطناعي مثل ChatGPT أو Claude أو Gemini وغيرها
- **التوازن بين الاكتمال والاختصار**: احفظ السياق بشكل كافٍ بدون إطالة مربكة، واستخدم أقساماً متداخلة للتفاصيل العميقة
- **إدارة الإصدارات**: أضف الطوابع الزمنية ومنصة المصدر لتتبع تطور السياق عبر عمليات التسليم المتعددة
- **التوجه العملي**: اختم دائماً بـ «برومبت الاستكمال» الواضح، وهو النص الجاهز الذي يستخدمه الذكاء الاصطناعي التالي
- **التكيّف مع حجم المشروع**: في ترحيل المشاريع الكبيرة، مثل الحالة الثالثة، وسّع قسم «هيكل المشروع» بشكل كبير مع إبقاء الأقسام الأخرى مختصرة
- **توثيق الإخفاقات**: وثّق صراحة ما لم ينجح ولماذا، حتى لا يكرر الذكاء الاصطناعي التالي نفس الأخطاء
- **حفظ القواعد**: عند تثبيت قواعد أو بروتوكولات خلال الجلسة، اذكر سبب الحاجة لها وليس نصها فقط
- **التحقق من الافتراضات**: علّم الافتراضات بوضوح كالتالي: «تم التحقق»، «بانتظار التحقق»، أو «غير صحيح»

- - لـ GEMINI / GEMINI-CLI / ANTIGRAVITY

نسخ مختصرة جداً:

GEMINI.md
```md
# وكيل Gemini AI عبر المنصات
```

workflow/agent/sample.toml
```toml
# قالب برومبت antigravity
```

MEMORY.md
```md
# ذاكرة Gemini

**الجلسة**: 2026-01-07 | Sprint 01 (متبقي 7 أيام) | Epic EPIC-001 (45%)  
**النشط**: TASK-001-03 inventory CRUD API (GET/POST مكتملة، PUT/DELETE معلّقة)  
**القرارات**: PostgreSQL + JSONB، RESTful /api/v1/، اختبار pytest  
**التالي**: إكمال endpoints الخاصة بـ PUT/DELETE وإنهاء schema
```