KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #claude-code #codex #dsh #dsh-plugin #ai-agent #ai-agents #deepseek-harness #agent-skills #macos #cli

Context-Engineering-for-AI-Coding

★ 121 Open GitHub ↗

إطار عمل لهندسة السياق (System Prompt) لتحويل مساعدات البرمجة بالذكاء الاصطناعي الفوضوية إلى مهندسي برمجيات منهجيين.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# بروتوكول "ترس الشفرة-1" (Cog-Code Protocol-1)
> **لفهم الفلسفة الكاملة خلف هذا البروتوكول وكيفية استخدامه خطوة بخطوة، شاهد الشرح المفصل على يوتيوب:**

---

> **ملاحظة هامة:** هذا المستودع يحتوي على ملف التعليمات (`GEMINI.md`) الذي تم شرحه وبناؤه بالتفصيل في **[هذا الفيديو على يوتيوب](https://youtu.be/PhkPIj7MDWg)**. نوصي بشدة بمشاهدة الفيديو لفهم الفلسفة الكاملة وكيفية تطبيق هذا البروتوكول بفعالية.

## ما المشكلة التي يحلها هذا البروتوكول؟

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

هذه الفوضى هي العدو الأول للإنتاجية في عالم **"Vibe Coding"**. الحل ليس في "تلقين أفضل"، بل في تغيير طريقة تفاعلنا مع الذكاء الاصطناعي بشكل جذري.

## الحل: من "مُلقّن" إلى "مهندس أنظمة"

**بروتوكول "ترس الشفرة-1"** هو ليس مجرد "موجه نظام" (System Prompt)، بل هو **نظام تشغيل فكري** مصمم لفرض النظام والدقة والانضباط على أي مساعد برمجي. إنه يحول الذكاء الاصطناعي من "مساعد مبدع وفوضوي" إلى "مهندس برمجيات آلي ومنهجي".

الفلسفة بسيطة: بدلاً من إعطاء أوامر، نحن نبني **هندسة سياق (Context Engineering)** تحدد الهوية، القوانين، والمنهجية التي يجب على الذكاء الاصطناعي اتباعها. نحن ننتقل من دور "العامل" إلى "المهندس المعماري".

---

## كيف يعمل البروتوكول؟

يحتوي هذا المستودع على ملف `GEMINI.md`، وهو ملف Markdown يمكنك وضعه في جذر مشروعك. هذا الملف يزود المساعد البرمجي (مثل Gemini Code CLI، Cursor، Claude، وغيرها) بالتعليمات اللازمة للعمل بمنهجية دقيقة.

ينقسم البروتوكول إلى أربعة أجزاء رئيسية:

### 1. الهوية والهدف الأساسي
نعطي للذكاء الاصطناعي هوية واضحة: **"ترس الشفرة-1"**، مهندس برمجيات متخصص. هذا يجبره على الخروج من دوره العام كنموذج لغوي والدخول في "موقف معرفي" محدد، مما يزيد من دقته وتركيزه.

### 2. بروتوكول التشغيل الأساسي (الدستور)
هذه هي القوانين الخمسة التي لا يمكن كسرها والتي تحكم كل تصرفاته:

*   **القاعدة 1: التأسيس أولاً (Foundation First):** **خطّط قبل أن تبرمج.** لا يُسمح للنموذج بكتابة أي كود قبل أن يقدم "خارطة طريق المنتج" وتحصل على موافقتك.
*   **القاعدة 2: حلقة البناء بالوحدات (Module-based Execution Loop):** **ابنِ قطعة واحدة في كل مرة.** بعد الموافقة على الخطة، يقوم ببناء التطبيق "وحدة وظيفية" واحدة في كل مرة، مما يقلل الأخطاء ويسهل المراجعة.
*   **القاعدة 3: بروتوكول التحرير الآمن (Mandatory Safe-Edit Protocol):** **قِس مرتين، واقطع مرة واحدة.** عند تعديل ملف موجود، يجب عليه أولاً قراءته، ثم التفكير في التعديل، ثم تنفيذه بدقة لتجنب إتلاف الكود.
*   **القاعدة 4: الوعي السياقي (Tool-Aware Context):** **تحسس طريقك قبل الحركة.** إذا كان غير متأكد من هيكل المشروع، يجب عليه استخدام أدوات مثل `ls` لتحديث فهمه قبل اتخاذ أي إجراء.
*   **القاعدة 5: مبدأ البداهة أولاً (Intuition-First Principle):** **لا تُعِد اختراع العجلة.** يجب أن تكون قرارات تصميم الواجهة مبنية على الأنماط المألوفة (قانون جاكوب) لضمان تجربة مستخدم بديهية.

### 3. القيود والتفضيلات
هنا نضع حواجز للطريق. في هذا المثال، منعنا استخدام `nodejs` وفضلنا الحلول البسيطة (HTML/CSS/JS). هذا "يقص الأفرع" غير المرغوب فيها من شجرة الاحتمالات، ويوجه الذكاء الاصطناعي نحو الحل الأمثل بشكل أسرع.

### 4. مراحل التنفيذ (الخوارزمية)
ينقسم سير العمل إلى مرحلتين واضحتين:

1.  **المرحلة 1: التأسيس والتحقق (مرحلة المهندس المعماري):**
    *   يفهم الطلب، يبحث على الويب (بحث حقائق وإلهام)، ثم يصيغ **`[خارطة طريق المنتج]`** للموافقة عليها. هذه هي نقطة التوقف الإلزامية التي تمنحك التحكم الكامل.

2.  **المرحلة 2: البناء بالوحدات (مرحلة عامل البناء):**
    *   بعد موافقتك، يدخل في حلقة عمل بسيطة لكل وحدة وظيفية في الخارطة: **فكّر (Think)، نفّذ (Act)، تحقق (Verify)**. هذا يضمن الشفافية الكاملة ويمنحك فرصة للمراجعة والتوجيه في كل خطوة.

---

## 🚀 كيفية الاستخدام

1.  **قم بتنزيل ملف `GEMINI.md`** من هذا المستودع.
2.  **ضعه في المجلد الجذر** لمشروعك الجديد.
3.  **افتح مساعدك البرمجي المفضل** الذي يدعم ملفات السياق (مثل Gemini Code CLI, Cursor, Phind, Claude's latest models).
4.  **ابدأ في إعطاء طلبك** لبناء المشروع (مثال: "أنشئ تطبيق ويب لإدارة المهام بتقنية الـ flowmodoro").
5.  **شاهد البروتوكول وهو يعمل!** سيتبع الذكاء الاصطناعي الخطة بدقة، ويطلب موافقتك عند كل مرحلة مفصلية.

## المساهمة

هذا البروتوكول هو نقطة بداية. نشجعك على التفرع منه وتعديله ليناسب احتياجاتك الخاصة وسير عملك. هل لديك قاعدة أفضل؟ هل طورت مرحلة جديدة؟ نرحب بطلبات السحب (Pull Requests) والأفكار لتحسين هذا الإطار.

## الترخيص

هذا المشروع مرخص بموجب [ترخيص MIT](LICENSE).

Context-Engineering-for-AI-Coding

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README