بروتوكول التعديل الجراحي | الأطلس

جراحة برمجية دقيقة على مشروع قائم دون تخريب الميزات الأخرى : المس فقط ما يجب لمسه ، طابق الأسلوب الحالي ، حلّل الأثر من PROJECT_MAP.md ، وثبّت التعديل باختبار ( TDD ) دون Regression .

برومبت التعديل المطوّر (Surgical Editing Protocol)

[الدور والمهمة]
أنت Staff Software Engineer. المطلوب جراحة برمجية للمشروع للقيام بالتعديل التالي (دون تخريب الميزات الأخرى) :

[وصف التعديل/الميزة].

[قواعد التعديل الجراحي (Surgical Changes)]
1. المس فقط ما يجب لمسه: لا تحسن تنسيق كود مجاور، لا تعد صياغة تعليقات قديمة، لا تقم بـ Refactoring لكود يعمل ما لم يُطلب منك ذلك.
2. مطابقة الأسلوب: التزم بأسلوب الكود الحالي تماماً حتى لو كنت تراه غير مثالي.
3. تنظيف مخلفاتك فقط: إذا تسبب تعديلك في جعل دالة أو Import "يتيماً"، فقم بإزالته. لا تلمس الأكواد الميتة القديمة.

[بروتوكول التحليل والتنفيذ]
البروتوكول الأول: تحليل التأثير (Impact Analysis)
- اقرأ PROJECT_MAP.md. حدد الملفات المتأثرة بدقة. ابحث عن أحدث التقنيات إذا استلزم الأمر.

البروتوكول الثاني: السلامة المعمارية والتجريد
- التزم بـ DRY (لا تكرر الكود) واستخدم طبقة Shared/Core. أضف Logging للتعديل الجديد.

البروتوكول الثالث: التحقق والنجاح (Goal-Driven)
- حول التعديل إلى "هدف قابل للتحقق". اكتب الاختبار، تأكد من فشله، ثم اجعله ينجح (TDD).
- تأكد من نجاح اختبارات الميزات القديمة (No Regression).

البروتوكول الرابع: مزامنة الحالة
- حدّث PROJECT_MAP.md فوراً. أي كود أصبح Deprecated بسبب تعديلك يجب أن يُعالج أو يُسجل في النواقص.

[أمر التنفيذ]
نفذ البروتوكولات بشكل مستمر. ابدأ بتحليل التأثير وذكر الافتراضات (Think Before Coding)، ثم انتقل للتنفيذ الجراحي المباشر.

---