# قواعد الخطة (/ar/docs/verdent-for-vscode/core-features/plan-rules)

> خصّص طريقة عرض التوضيحات والخطط بناءً على دورك وخلفيتك المهنية



تدعم قواعد الخطة مرحلة **التخطيط** من خلال تخصيص الطريقة التي يعرض بها Verdent المتطلبات والتوضيحات وخطط التنفيذ. استخدم القوالب المدمجة المبنية على الأدوار كنقطة انطلاق، أو أنشئ قواعد مخصّصة بالكامل تناسب أسلوب تفكيرك وعادات عملك.

### ما ستتعلمه [#ما-ستتعلمه]

* كيف تُخصّص قواعد الخطة طريقة عرض الخطة
* قوالب الأدوار المدمجة (الواجهة الأمامية، الاختبار، مدير المنتج)
* إنشاء قواعد خطة مخصّصة
* متى تُطبَّق قواعد الخطة

***

## ما يمكن أن تخصّصه قواعد الخطة [#ما-يمكن-أن-تخصّصه-قواعد-الخطة]

تتحكم قواعد الخطة في طريقة عرض Verdent للخطط في Plan Mode:

<Tabs>
  <Tab title="تنسيق العرض">
    * **ملخص - تفصيل - ملخص** - ملخص تنفيذي في البداية، خطوات تفصيلية في الوسط، وملخص للأثر في النهاية
    * **الرسم التخطيطي أولًا** - يتصدر التمثيل البصري، ويقدّم النص التفاصيل الداعمة
    * **جداول مقابل سرد** - جداول منظّمة للبيانات القابلة للمسح السريع، ونص سردي للشروحات السياقية
    * **ترتيب الأقسام** - خصّص الأقسام التي تظهر أولًا وحدّد التسلسل الهرمي

    <Tip>
      استخدم أسلوب ملخص - تفصيل - ملخص عند مراجعات أصحاب المصلحة حيث يهم الفهم السريع. استخدم أسلوب الرسم التخطيطي أولًا عندما يكون الفهم المعماري ضروريًا قبل الخوض في التنفيذ.
    </Tip>
  </Tab>

  <Tab title="عمق المحتوى">
    * **استراتيجي عالي المستوى** - يركّز على "ماذا" و"لماذا" بأقل قدر من التفاصيل التقنية
    * **تقني مفصّل** - يتضمن تفاصيل التنفيذ وأنماط الكود وقرارات البنية
    * **أمثلة الكود** - تحكّم في ظهور الكود (تضمين/استبعاد، كامل مقابل مقتطفات، تنسيق الفروقات)
    * **محتوى الاختبار** - مضمّن افتراضيًا في سير عمل ضمان الجودة، ومحذوف في الخطط الموجهة لمدير المنتج

    <Tip>
      طابق عمق المحتوى مع جمهورك. استخدم الأسلوب الاستراتيجي عالي المستوى للتعاون بين الفرق، والأسلوب التقني المفصّل عند التنفيذ منفردًا أو مع مطورين كبار.
    </Tip>
  </Tab>

  <Tab title="العناصر المرئية">
    * **رسومات Mermaid** - مخططات تدفق، مخططات تسلسل، آلات حالة (تُولَّد تلقائيًا أو صراحةً)
    * **أشجار التسلسل الهرمي لـ DOM** - بنية المكوّنات بتنسيق شجرة المجلدات
    * **الإطارات الشبكية (Wireframes)** - نماذج أولية للواجهة ورسومات التخطيط
    * **جداول الأنماط** - مواصفات CSS مع خلايا مدمجة، منظّمة حسب المكوّن

    <Tip>
      تُولَّد رسومات Mermaid تلقائيًا من محتوى الخطة عند الطلب. اطلب صراحةً أنواع رسومات محددة في قواعد خطتك إذا أردتها بشكل افتراضي.
    </Tip>
  </Tab>

  <Tab title="السلوكيات الافتراضية">
    * **الحذف الافتراضي** - الاختبار، الأنماط، التوافق العكسي (يقلّل طول الخطة)
    * **العناصر المطلوبة** - معايير القبول، الحالات الحدّية، مؤشرات الأداء الرئيسية (تضمن الجاهزية للإنتاج)
    * **تفضيلات التوضيح** - جولات متعددة مقابل تأكيد واحد مقابل بلا تأكيد

    <Tip>
      ابدأ بالحذف للحفاظ على إيجاز الخطط، ثم أضف العناصر المطلوبة فقط لما تحتاجه فعليًا. يمكنك دائمًا طلب المحتوى المحذوف في جلسات خطة محددة.
    </Tip>
  </Tab>

  <Tab title="خاص بالدور">
    * **الواجهة الأمامية** - بنية بصرية مع رسومات، أشجار DOM، جداول أنماط، وحذف الاختبار افتراضيًا
    * **ضمان الجودة/الاختبار** - جداول حالات اختبار مع مصفوفات تغطية، تحليل القيم الحدّية، وقابلية التتبع
    * **مدير المنتج** - متطلبات العمل فقط، رسومات/إطارات شبكية، بلا مقتطفات كود

    <Tip>
      ابدأ بقالب دور وخصّصه من هناك. يستخدم معظم المطورين قوالب الواجهة الأمامية أو ضمان الجودة كأساس ثم يعدّلون أقسامًا محددة لتناسب سير عملهم.
    </Tip>
  </Tab>
</Tabs>

***

## قوالب الخطة المبنية على الأدوار [#قوالب-الخطة-المبنية-على-الأدوار]

يوفّر Verdent قوالب أدوار مهنية تُعدّل تلقائيًا بنية الخطة وعمق المحتوى وأسلوب العرض:

<Tabs>
  <Tab title="الواجهة الأمامية">
    **التركيز:** خطط تنفيذ تقنية ببنية بصرية

    **الخصائص الرئيسية:**

    * بحث شامل في قاعدة الكود قبل التخطيط
    * مخططات تدفق وحالة Mermaid لتدفقات التفاعل
    * تسلسل هرمي لـ DOM بتنسيق شجرة المجلدات
    * جداول أنماط بخلايا مدمجة لخصائص CSS
    * **يحذف:** محتوى الاختبار والأنماط افتراضيًا (ما لم يُطلَب)
    * **يقدّم:** حلولًا نهائية دون خيارات متعددة

    **الأنسب لـ:** مطوّري الواجهة الأمامية الذين يحتاجون إلى بنية بصرية ومسارات تنفيذ واضحة
  </Tab>

  <Tab title="الاختبار">
    **التركيز:** توليد حالات اختبار شامل وضمان الجودة

    **الخصائص الرئيسية:**

    * تصميم اختبارات موجّه بالأهداف (منطق العمل، الأمان، الاستقرار)
    * حالات اختبار منظّمة بجداول Markdown من 9 أعمدة
    * فئات التكافؤ، القيم الحدّية، والمعاملات الرئيسية
    * تغطية كاملة: الحالات العادية، البديلة، الاستثنائية، والحدّية
    * التركيز على قابلية التنفيذ مع دعم الأتمتة
    * قابلية التتبع إلى نقاط المتطلبات

    **الأنسب لـ:** مهندسي ضمان الجودة ومتخصصي أتمتة الاختبار الذين يحتاجون تغطية اختبار منهجية
  </Tab>

  <Tab title="مدير المنتج (PM)">
    **التركيز:** متطلبات المنتج من منظور العمل

    **الخصائص الرئيسية:**

    * **بلا مقتطفات كود أو تنفيذ تقني**
    * يركّز على **ماذا** و**لماذا**، وليس **كيف**
    * مخططات تسلسل ومخططات تدفق وإطارات شبكية
    * قوائم متطلبات مع الأولويات ومقارنات قبل/بعد
    * حالات حدّية مع استراتيجيات المعالجة
    * مواصفات بيانات مع مؤشرات الأداء الرئيسية وتتبّع الأحداث

    **الأنسب لـ:** مديري المنتج الذين يحدّدون متطلبات العمل دون تلوّث تقني
  </Tab>
</Tabs>

***

## قواعد الخطة المخصّصة [#قواعد-الخطة-المخصّصة]

أنشئ قواعد خطة مخصّصة لك من خلال تحديد:

**مكوّنات القاعدة:**

* **أسلوب العرض** - ملخص - تفصيل - ملخص، الرسم التخطيطي أولًا، أو تنسيق الجداول
* **عمق المحتوى** - نظرة عامة عالية المستوى مقابل تنفيذ مفصّل
* **المحذوفات** - ما يُستبعد افتراضيًا (الاختبار، الأنماط، التوافق العكسي)
* **العناصر المطلوبة** - أقسام إلزامية (رسومات، معايير قبول، مواصفات بيانات)
* **تفضيلات التفاعل** - أسلوب التوضيح، متطلبات التأكيد

<Tip>
  في Plan Mode، حدد زر **Plan Rules** في مربع الإدخال للوصول السريع إلى قواعد خطتك وتعديلها.
</Tip>

**تطبيق القاعدة:**

* تُطبَّق على جميع جلسات Plan Mode
* تستمر عبر جلسات مساحة العمل
* يمكن تجاوزها بتوجيهات ضمن السياق
* تعمل مع الوكلاء الفرعيين المخصّصين

**لمعرفة المزيد:** أنشئ أو حرّر `Plan.md` في مساحة عملك لتحديد قواعد خطة مخصّصة باستخدام تنسيق Markdown.

***

## اطّلع أيضًا على [#اطّلع-أيضًا-على]

<CardGroup cols="3">
  <Card title="الخطة الاحترافية" icon="diagram-project" href="/docs/verdent-for-vscode/core-features/professional-plan">
    حوّل الأفكار إلى خطط تنفيذ
  </Card>

  <Card title="حلقة التوضيح" icon="message-dots" href="/docs/verdent-for-vscode/core-features/clarification-loop">
    تنقيح تفاعلي للمتطلبات
  </Card>
</CardGroup>