القواعد

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

ما ستتعلمه

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

أنواع القواعد

الموقع:

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

قواعد المستخدم (VERDENT.md)

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

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

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

# 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

قواعد المشروع (AGENTS.md)

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

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

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

# 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

كتابة قواعد فعّالة

كن محددًا:

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

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

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

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

الأسئلة المتكررة