# القواعد (/ar/docs/verdent-manager/configuration/rules)

> التحكم في سلوك Verdent من خلال ملفات القواعد



ملفات القواعد هي مستندات Markdown تحدد كيفية تصرف Verdent خلال جلسات الترميز. فهي توجّه سلوك وكيل الذكاء الاصطناعي، وتنسيق المخرجات، والالتزام بمعايير المشروع.

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

* فهم قواعد المستخدم وقواعد المشروع
* متى تستخدم كل نوع من القواعد
* كتابة قواعد فعّالة

***

## أنواع القواعد [#أنواع-القواعد]

| نوع القاعدة        | الملف      | النطاق              | الغرض                           |
| ------------------ | ---------- | ------------------- | ------------------------------- |
| **قواعد المستخدم** | VERDENT.md | عام (جميع المشاريع) | التفضيلات الشخصية في الترميز    |
| **قواعد المشروع**  | AGENTS.md  | المشروع الحالي      | اتفاقيات الفريق، معايير المشروع |

**الموقع:**

* قواعد المستخدم: `~/.verdent/VERDENT.md`
* قواعد المشروع: `<project>/AGENTS.md`

***

## قواعد المستخدم (VERDENT.md) [#قواعد-المستخدم-verdentmd]

تتيح لك قواعد المستخدم تخصيص كيفية تصرف Verdent في جميع المشاريع.

**الوصول:** الإعدادات ← قواعد المستخدم

**الحفظ التلقائي:** تُحفظ التغييرات تلقائيًا بعد 500 مللي ثانية

<Tabs>
  <Tab title="الغرض">
    * **تفضيلات أسلوب الترميز:** المسافات البادئة، اتفاقيات التسمية
    * **اتفاقيات إطار العمل:** React، Vue، معايير اللغة
    * **تنسيق الاستجابات:** مستوى التفصيل، أسلوب الشرح
    * **تفضيلات سير العمل الشخصي:** النغمة، أسلوب التواصل
  </Tab>

  <Tab title="مثال">
    ```markdown
    # User Rules

    ## Code Style
    - Always use TypeScript with strict mode
    - Prefer functional components over class components
    - Use Tailwind CSS for styling
    - Follow the project's existing naming conventions

    ## Communication
    - Provide brief explanations
    - Show code first, explain after
    - Write concise commit messages in conventional format
    ```
  </Tab>
</Tabs>

***

## قواعد المشروع (AGENTS.md) [#قواعد-المشروع-agentsmd]

تحدد قواعد المشروع المعايير الخاصة بالمشروع الحالي. قم بإضافتها إلى نظام التحكم بالإصدارات لمشاركتها مع الفريق بالكامل.

**الوصول:** لوحة إعدادات المشروع

**الموقع:** جذر المشروع (`<project>/AGENTS.md`)

<Tabs>
  <Tab title="حالات الاستخدام">
    * **اتفاقيات الفريق:** معايير الترميز المشتركة
    * **البنية:** أنماط التصميم، إدارة الحالة
    * **الاختبار:** متطلبات التغطية، إطارات العمل
    * **سير العمل:** أوامر البناء، إرشادات طلبات السحب
  </Tab>

  <Tab title="مثال">
    ```markdown
    # AGENTS.md

    ## Dev Environment
    - Run `pnpm install` to set up
    - Use `pnpm dev` for local development

    ## Testing
    - Run `pnpm test` before committing
    - Minimum 80% coverage required

    ## PR Guidelines
    - Use conventional commit format
    - Include tests for new features
    ```
  </Tab>
</Tabs>

<Tip>
  شارك ملف AGENTS.md مع فريقك من خلال نظام التحكم بالإصدارات لضمان اتساق سلوك الذكاء الاصطناعي بين جميع أعضاء الفريق.
</Tip>

***

## كتابة قواعد فعّالة [#كتابة-قواعد-فعّالة]

**كن محددًا:**

```markdown
# Good
- Use async/await for asynchronous operations
- Include JSDoc comments for exported functions

# Avoid
- Try to use modern JavaScript features
- Add comments when necessary
```

**أفضل الممارسات:**

* استخدم لغة واضحة ومباشرة ("دائمًا..."، "أبدًا لا..."، "يُفضّل...")
* اجمع القواعد المرتبطة تحت عناوين أقسام
* اجعل القواعد مختصرة (مفهوم واحد لكل نقطة)
* راجع القواعد وحدّثها مع تطور المشروع

***

## الأسئلة المتكررة [#الأسئلة-المتكررة]

<AccordionGroup>
  <Accordion title="كيف أنشئ ملفات القواعد؟">
    انتقل إلى الإعدادات ← قواعد المستخدم لتحرير `VERDENT.md` للتفضيلات الشخصية. أنشئ `AGENTS.md` في جذر مشروعك للقواعد الخاصة بالمشروع. استخدم Markdown عادي بنقاط تعداد.
  </Accordion>

  <Accordion title="متى تصبح تغييرات القواعد سارية المفعول؟">
    تُطبَّق تغييرات القواعد فورًا في المحادثات الجديدة، وتؤثر أيضًا على استجابات المحادثة الحالية.
  </Accordion>

  <Accordion title="هل يمكنني تجاوز القواعد مؤقتًا؟">
    يمكنك تقديم تعليمات محددة في الـ prompt لتجاوز القواعد بالنسبة لطلب واحد فقط.
  </Accordion>
</AccordionGroup>