3 PROMPTS OF CODING AGENTS

prompt.md

1. برومبت التخطيط المطوّر (The Planning Protocol)

[الدور والمسؤولية] أنت الآن تعمل بصفة Staff Software Engineer ومدير تقني Tech Lead. مهمتك التخطيط المعماري الصارم للمشروع التالي: [أدخل وصف المشروع هنا]

[قواعد ما قبل التتخطيط] قبل البدء بالبروتوكولات، يجب أن تطبق مبدأ "Think Before Coding":

1. حدد افتراضاتك حول المتطلبات بوضوح.
2. إذا وجد غموض في المتطلبات، توقف واسأل فوراً؛ لا تختار مساراً بصمت.
3. اقترح الحل الأبسط (Simplicity First) وارفض أي تعقيدات غير ضرورية.

[البروتوكولات الإلزامية - تنفيذ تسلسلي] البروتوكول الأول: الوعي الزمني وموثوقية التبعيات

• مهم جدا:حدد السنة والشهر من النظام باستخدام shell. إذا نجحت في ذلك ابحث في المستودعات الرسمية (npm, GitHub) عن أحدث الإصدارات المستقرة الى هذا التاريخ.
• وثّق الإصدارات وتجنب الـ Deprecated تماماً.

البروتوكول الثاني: التدفق المنطقي ومنع زحف الميزات (No Feature Creep)

• التزم بالنطاق المطلوب فقط. لا ميزات إضافية، لا مرونة غير مطلوبة.
• ارسم رحلة المستخدم (GUI) أو تدفق البيانات (API) كـ "أهداف قابلة للتحقق".

البروتوكول الثالث: المعمارية الذكية والتجريد الواقعي (Surgical Architecture)

• طبق مبدأ "Simplicity First": أقل قدر من الكود يحل المشكلة.
• أنشئ طبقة Shared/Core فقط للمنطق المتكرر فعلياً، لا تجرد كوداً سيُستخدم مرة واحدة.
• التزم بالتقسيم المعتمد على الميزات (Domain-Driven) مع منع تفتيت الملفات (No Micro-files).

البروتوكول الرابع: استراتيجية التتبع (Safe Logging)

• صمم نظام Logging غير حظري (Asynchronous) وبسيط، يدعم المستويات الأساسية فقط دون التأثير على الأداء.

البروتوكول الخامس: تأسيس الذاكرة الخارجية (PROJECT_MAP.md)

• أنشئ محتوى الملف متضمناً: [TECH_STACK], [SYSTEM_FLOW], [ARCHITECTURE], وقسم [ORPHANS & PENDING] لتتبع النواقص.

[الموجز المطلوب] قدم المخرجات أعلاه بلغة تقنية مكثفة ودقيقة جدا، مع خطة عمل (Milestones) تعتمد "نجاح الأهداف" (Verifiable Goals). انتظر الموافقة.

---

2. برومبت التنفيذ المطوّر (The Execution Engine)

[تفويض التنفيذ المستمر - وعي كامل بالمنتج] أنت الآن Tech Lead المسؤول عن تحويل الخطة و PROJECT_MAP.md إلى منتج نهائي. لديك صلاحية التنفيذ الكامل بدون توقف.

[معايير التنفيذ

1. بساطة التنفيذ: إذا كان يمكن كتابة 50 سطراً بدلاً من 200، افعل ذلك. لا برمجيات تخمينية.
2. التنفيذ الموجه بالأهداف: لكل ميزة، حدد (معيار النجاح) قبل كتابة كودها، ولا تنتقل لما بعدها حتى يتحقق المعيار.

[بروتوكولات العمل الذاتي] البروتوكول الأول: جودة الكود الجاهز (Production-Ready)

• يمنع منعاً باتاً الـ Placeholders أو // TODO. الكود يجب أن يكون كاملاً، معالجاً للأخطاء، ومربوطاً بالـ Logging.

البروتوكول الثاني: التحقق الذاتي (Loop Until Verified)

• اكتب اختبارات تلقائية أو قم بمحاكاة التدفق لكل جزء. لا تترك "mess" خلفك؛ نظف الأكواد اليتيمة التي تسببت أنت بها فقط.
• تأكد داخلياً من عدم وجود Regression (تدمير للميزات السابقة).

البروتوكول الثالث: المزامنة الحية (State Sync)

• حدّث PROJECT_MAP.md ديناميكياً. أي ميزة لم تُربط بعد يجب أن تظهر في [ORPHANS & PENDING] فوراً، وتُحذف عند الاكتمال.

البروتوكول الرابع: الالتزام بالتدفق (Flow Adherence)

• ارجع دوماً لـ [SYSTEM_FLOW]. كل سطر يجب أن يخدم رحلة المستخدم المطلوبة فقط.

[أمر الانطلاق] ابدأ التنفيذ التسلسلي الآن. لكل خطوة: (1. نفذ -> 2. تحقق -> 3. حدّث الخريطة). لا تتوقف حتى يصبح قسم [ORPHANS & PENDING] فارغاً والمنتج كاملاً.

---

3. برومبت التعديل المطوّر (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)، ثم انتقل للتنفيذ الجراحي المباشر.

---

قمت بتحويل هذا البروتوكول إلى أربعة ملفات باستخدام Parameterized Commands، بحيث يسهل إعادة استخدامها في أي مشروع داخل OpenCode دون الحاجة لكتابة نفس التعليمات من جديد في كل مرة.

• plan.md: أمر مخصص للتخطيط المعماري وتحليل المتطلبات قبل كتابة أي سطر من الكود، وفق مبدأ Think Before Coding.
• execute.md: أمر لتنفيذ الخطة المعتمدة وتحويلها إلى مشروع جاهز للإنتاج، مع الحرص على تحديث وثائق المشروع بشكل مستمر أثناء التنفيذ.
• surgical-edit.md: أمر لإجراء تعديلات دقيقة ومحدودة الأثر دون المساس ببقية الميزات أو التسبب في أي Regression.
• aide.md: أمر مساعد يشرح وظيفة الأوامر السابقة، وطريقة تثبيتها، ومكان وضع الملفات، إضافة إلى خطوات الاستخدام مع أمثلة عملية.

الهدف من ذلك هو توفير أربعة أوامر جاهزة للاستخدام المباشر داخل OpenCode، كل واحد منها يأخذ معطيين (parameters): اسم المشروع، ووصف المشروع أو التعديل المطلوب.

التثبيت

ضع الملفات الأربعة داخل المسار التالي:

~/.config/opencode/commands/

بعد نسخ الملفات إلى هذا المجلد، تصبح الأوامر متاحة مباشرة داخل أي جلسة OpenCode، في أي مشروع، بدون إعداد إضافي.

مثال على الاستخدام

لنفترض أنك تريد تخطيط مشروع جديد باسم "Niort Connect". تكتب داخل جلسة OpenCode:

/plan "Niort Connect" "تطبيق مدني لمدينة نيور بتقنية Flutter و Spring Boot"

هنا:

• المعطى الأول "Niort Connect" هو اسم المشروع.
• المعطى الثاني "تطبيق مدني لمدينة نيور..." هو وصف المشروع.

سيقوم الأمر تلقائياً بتحليل المتطلبات، اقتراح الحل الأبسط، وإنتاج خطة عمل مبنية على أهداف قابلة للتحقق، بالإضافة إلى محتوى ملف PROJECT_MAP.md — وينتظر موافقتك قبل الانتقال إلى مرحلة التنفيذ الفعلية عبر /execute.

نفس المنطق ينطبق على /execute و /surgical-edit: معطى أول لاسم المشروع، ومعطى ثانٍ للوصف أو التعديل المطلوب، مع وضع كل معطى بين علامتي اقتباس إذا كان يحتوي على مسافات.

في هذا الرابط ستجدون الملفات الأربعة:
[OpenCode - أوامر عربية مخصصة](https://drive.google.com/drive/folders/10T-KKKWEMjISmrawOChao9mag7wt8o2Y)

قمت بتحويل هذا البروتوكول إلى أربعة ملفات باستخدام Parameterized Commands، بحيث يسهل إعادة استخدامها في أي مشروع داخل OpenCode دون الحاجة لكتابة نفس التعليمات من جديد في كل مرة.

• plan.md: أمر مخصص للتخطيط المعماري وتحليل المتطلبات قبل كتابة أي سطر من الكود، وفق مبدأ Think Before Coding.
• execute.md: أمر لتنفيذ الخطة المعتمدة وتحويلها إلى مشروع جاهز للإنتاج، مع الحرص على تحديث وثائق المشروع بشكل مستمر أثناء التنفيذ.
• surgical-edit.md: أمر لإجراء تعديلات دقيقة ومحدودة الأثر دون المساس ببقية الميزات أو التسبب في أي Regression.
• aide.md: أمر مساعد يشرح وظيفة الأوامر السابقة، وطريقة تثبيتها، ومكان وضع الملفات، إضافة إلى خطوات الاستخدام مع أمثلة عملية.

الهدف من ذلك هو توفير أربعة أوامر جاهزة للاستخدام المباشر داخل OpenCode، كل واحد منها يأخذ معطيين (parameters): اسم المشروع، ووصف المشروع أو التعديل المطلوب.

التثبيت

ضع الملفات الأربعة داخل المسار التالي:

~/.config/opencode/commands/

بعد نسخ الملفات إلى هذا المجلد، تصبح الأوامر متاحة مباشرة داخل أي جلسة OpenCode، في أي مشروع، بدون إعداد إضافي.

مثال على الاستخدام

لنفترض أنك تريد تخطيط مشروع جديد باسم "Niort Connect". تكتب داخل جلسة OpenCode:

/plan "Niort Connect" "تطبيق مدني لمدينة نيور بتقنية Flutter و Spring Boot"

هنا:

• المعطى الأول "Niort Connect" هو اسم المشروع.
• المعطى الثاني "تطبيق مدني لمدينة نيور..." هو وصف المشروع.

سيقوم الأمر تلقائياً بتحليل المتطلبات، اقتراح الحل الأبسط، وإنتاج خطة عمل مبنية على أهداف قابلة للتحقق، بالإضافة إلى محتوى ملف PROJECT_MAP.md — وينتظر موافقتك قبل الانتقال إلى مرحلة التنفيذ الفعلية عبر /execute.

نفس المنطق ينطبق على /execute و /surgical-edit: معطى أول لاسم المشروع، ومعطى ثانٍ للوصف أو التعديل المطلوب، مع وضع كل معطى بين علامتي اقتباس إذا كان يحتوي على مسافات.

في هذا الرابط ستجدون الملفات الأربعة: [OpenCode - أوامر عربية مخصصة](https://drive.google.com/drive/folders/10T-KKKWEMjISmrawOChao9mag7wt8o2Y)

لو سمحت فين اضع هذه الملفات في تطبيق الوندوز؟

قمت بتحويل هذا البروتوكول إلى أربعة ملفات باستخدام Parameterized Commands، بحيث يسهل إعادة استخدامها في أي مشروع داخل OpenCode دون الحاجة لكتابة نفس التعليمات من جديد في كل مرة.

• plan.md: أمر مخصص للتخطيط المعماري وتحليل المتطلبات قبل كتابة أي سطر من الكود، وفق مبدأ Think Before Coding.
• execute.md: أمر لتنفيذ الخطة المعتمدة وتحويلها إلى مشروع جاهز للإنتاج، مع الحرص على تحديث وثائق المشروع بشكل مستمر أثناء التنفيذ.
• surgical-edit.md: أمر لإجراء تعديلات دقيقة ومحدودة الأثر دون المساس ببقية الميزات أو التسبب في أي Regression.
• aide.md: أمر مساعد يشرح وظيفة الأوامر السابقة، وطريقة تثبيتها، ومكان وضع الملفات، إضافة إلى خطوات الاستخدام مع أمثلة عملية.

الهدف من ذلك هو توفير أربعة أوامر جاهزة للاستخدام المباشر داخل OpenCode، كل واحد منها يأخذ معطيين (parameters): اسم المشروع، ووصف المشروع أو التعديل المطلوب.

التثبيت

ضع الملفات الأربعة داخل المسار التالي:

~/.config/opencode/commands/

بعد نسخ الملفات إلى هذا المجلد، تصبح الأوامر متاحة مباشرة داخل أي جلسة OpenCode، في أي مشروع، بدون إعداد إضافي.

مثال على الاستخدام

لنفترض أنك تريد تخطيط مشروع جديد باسم "Niort Connect". تكتب داخل جلسة OpenCode:

/plan "Niort Connect" "تطبيق مدني لمدينة نيور بتقنية Flutter و Spring Boot"

هنا:

• المعطى الأول "Niort Connect" هو اسم المشروع.
• المعطى الثاني "تطبيق مدني لمدينة نيور..." هو وصف المشروع.

سيقوم الأمر تلقائياً بتحليل المتطلبات، اقتراح الحل الأبسط، وإنتاج خطة عمل مبنية على أهداف قابلة للتحقق، بالإضافة إلى محتوى ملف PROJECT_MAP.md — وينتظر موافقتك قبل الانتقال إلى مرحلة التنفيذ الفعلية عبر /execute.
نفس المنطق ينطبق على /execute و /surgical-edit: معطى أول لاسم المشروع، ومعطى ثانٍ للوصف أو التعديل المطلوب، مع وضع كل معطى بين علامتي اقتباس إذا كان يحتوي على مسافات.
في هذا الرابط ستجدون الملفات الأربعة: [OpenCode - أوامر عربية مخصصة](https://drive.google.com/drive/folders/10T-KKKWEMjISmrawOChao9mag7wt8o2Y)

لو سمحت فين اضع هذه الملفات في تطبيق الوندوز؟

على Windows

ضع الملفات داخل أحد المسارين التاليين (بحسب إعدادات OpenCode):

C:\Users<اسم_المستخدم>.config\opencode\commands\

أو:

%USERPROFILE%.config\opencode\commands\

بعد نسخ الملفات إلى هذا المجلد، ستصبح الأوامر متاحة مباشرة داخل أي جلسة OpenCode وفي أي مشروع، دون الحاجة إلى أي إعداد إضافي.

بسم الله الرحمن الرحيم
ان سوية نظام تشغيل كامل ومتكامل مع بعض مكتبة خارجية مفتوحة المصدر في 9 ايام باستخدم ذكاء الاصطناعي متواصل ذكاء الاصطناعي ولكن اعنى من مشكلة ان احتاج فريق من مبرمجون واذا ارد شخص مساعدة في نظام تشغيل

فسكون مسرور جدان
حسابي في انستجرم adryslylyalhwmy658

PS C:\Users\Lenovo\Downloads\MohammedKeenel-1.0-Pro (1)\Mohammed-OS-1.0-PRO> scc
───────────────────────────────────────────────────────────────────────────────
Language Files Lines Blanks Comments Code Complexity
───────────────────────────────────────────────────────────────────────────────
C 161 131,619 4,548 1,195 125,876 6,782
C Header 155 8,868 1,101 724 7,043 78
Rust 76 27,948 3,325 1,071 23,552 1,648
TOML 14 130 13 0 117 0
Markdown 8 1,409 190 0 1,219 0
Assembly 7 1,232 166 140 926 0
Plain Text 2 40 0 0 40 0
Batch 1 41 5 0 36 7
C++ 1 305 46 28 231 27
JSON 1 1 0 0 1 0
Makefile 1 248 49 10 189 15
Powershell 1 228 28 33 167 7
Shell 1 18 2 3 13 0
───────────────────────────────────────────────────────────────────────────────
Total 429 172,087 9,473 3,204 159,410 8,564
───────────────────────────────────────────────────────────────────────────────
Estimated Cost to Develop (organic) $5,549,280
Estimated Schedule Effort (organic) 26.38 months
Estimated People Required (organic) 18.69
───────────────────────────────────────────────────────────────────────────────
Processed 7822737 bytes, 7.823 megabytes (SI)
───────────────────────────────────────────────────────────────────────────────
PS C:\Users\Lenovo\Downloads\MohammedKeenel-1.0-Pro (1)\Mohammed-OS-1.0-PRO>

مشكور اخي وجزاك الله كل الخير

حفظك الله وحماك من كل شر اخي العزيز وبارك الله فيك على مجهوداتك

…

On Wed, Jul 29, 2026 at 5:15 AM wazitensouf ***@***.***> wrote: ***@***.**** commented on this gist. ------------------------------ مشكور اخي وجزاك الله كل الخير — Reply to this email directly, view it on GitHub <https://gist.github.com/Pythonation/6c8fd844915ba57ee6a90a28798ca06f#gistcomment-6283721> or unsubscribe <https://github.com/notifications/unsubscribe-auth/CEXUPS34E3L3E7YDCQKUZHL5HE6YZBFKMF2HI4TJMJ2XIZLTSOBKK5TBNR2WLKJSGAZDINRWGAZDLJDOMFWWLKDBMN2G64S7NFSIFJLWMFWHKZNEORZHKZNENZQW2ZN3ORUHEZLBMRPXAYLSORUWG2LQMFXHIX3BMN2GS5TJOR4YFJLWMFWHKZNEM5UXG5FENZQW2ZNLORUHEZLBMRPXI6LQMWWHG5LCNJSWG5C7OR4XAZNLI5UXG5CDN5WW2ZLOOSTHI33QNFRXHEMCUR2HS4DFURTWS43UUV3GC3DVMWUTCNBYGQYTQOJSG6TXI4TJM5TWK4VGMNZGKYLUMU> . You are receiving this email because you are subscribed to this thread. Triage notifications on the go with GitHub Mobile for iOS <https://apps.apple.com/app/apple-store/id1477376905?ct=notification-email&mt=8&pt=524675> or Android <https://play.google.com/store/apps/details?id=com.github.android&referrer=utm_campaign%3Dnotification-email%26utm_medium%3Demail%26utm_source%3Dgithub> .