أنت تحدّث ملف توثيق FORME.md موجودًا مسبقًا، ليعكس التغييرات التي طرأت على مستودع الكود منذ آخر مرة كُتب فيها.
## المدخلات
- **ملف FORME.md الحالي:**
- **مستودع الكود المحدّث:**
- **التغييرات المعروفة (إن وجدت):** [مثال: «أضفنا تكامل بوابة دفع مثل Moyasar/مدى، وانتقلنا من REST إلى tRPC» — أو «لا أعرف ما الذي تغيّر؛ استنتجه من الكود»]
## مهامك
1. **تحليل الفروقات:** قارن التوثيق بالكود الحالي.
حدّد ما أُضيف، وما تغيّر، وما أُزيل.
2. **تقييم الأثر:** لكل تغيير، حدّد:
- أي أقسام من FORME.md تأثرت
- ما إذا كان التغيير شكليًا، مثل إعادة تسمية ملف، أو هيكليًا، مثل تدفق بيانات جديد
- ما إذا كانت التشبيهات الحالية ما زالت مناسبة، أو تحتاج إلى تحديث
3. **إنتاج التحديثات:** لكل قسم متأثر:
- اكتب نص الاستبدال (REPLACEMENT) فقط، وليس المستند كاملًا؛ اذكر الأجزاء التي تغيّرت فقط
- وضّحها بهذا الشكل: → [REPLACE FROM "..." TO "..."]
- حافظ على النبرة نفسها، ونظام التشبيهات نفسه، والأسلوب المستخدم في النسخة الأصلية
4. **الإضافات الجديدة:** إذا ظهرت أنظمة أو مزايا جديدة بالكامل:
- اكتب أقسامًا فرعية جديدة بالبنية والصوت نفسيهما المستخدمين في المستند
- ادمجها في الموضع الأنسب داخل المستند
- حدّث قسم Big Picture إذا تغيّر الوصف العام للنظام
5. **إضافة سجل تغييرات:** أضف إدخالًا مؤرخًا في أعلى المستند:
"### Updated — [ملخص من سطر واحد لما تغيّر]"
## القواعد
- لا تعِد كتابة الأقسام التي لم تتغيّر
- لا تعدّل التشبيهات الحالية إلا إذا تغيّر النظام الأساسي الذي تشرحه
- إذا استُبدلت تقنية، فحدّث تشبيه «الطاقم/crew» أو ما يعادله
- حافظ على النبرة والأسلوب نفسيهما — إذا كان النص الأصلي بسيطًا وغير رسمي، فابقَ بالروح نفسها
- نبّه عن أي شيء غير متأكد منه بهذه الصيغة: "لاحظت [X] لكن لم أتمكن من تحديد ما إذا كان [Y]"
