سير العمل القائم على التخطيط أولاً

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

متى تستخدم Plan Mode

تغييرات معقدة تشمل عدة ملفات وتتطلب تنسيقًا
عدم اليقين بشأن أفضل نهج للتنفيذ
تغييرات عالية المخاطر على كود بالغ الأهمية في الإنتاج
مهام في قواعد كود غير مألوفة تتطلب الاستكشاف
احتياجات تخطيط استراتيجي تتطلب موافقة قبل التنفيذ

تقسيم المهام بمساعدة الذكاء الاصطناعي

يقوم Verdent تلقائيًا بتفكيك الطلبات المعقدة إلى خطوات متسلسلة وقابلة للإدارة من خلال تقسيم المهام بمساعدة الذكاء الاصطناعي.

عملية التقسيم

تحليل الطلب

يحلل Verdent طلبك المكتوب بلغة طبيعية لتحديد:

الهدف الأساسي والنتيجة المرغوبة
الملفات أو المكونات أو الأنظمة المتأثرة
العمليات التقنية والتبعيات المطلوبة
عوامل التعقيد المحتملة

سياق قاعدة الكود

يفحص Verdent بنية مشروعك لفهم:

البنية الحالية والأنماط المعتمدة
تنظيم الملفات وحزمة التقنيات
التنفيذات الحالية التي تحتاج إلى تعديل

تفكيك المهمة

يقسّم Verdent الطلب إلى مهام فرعية منطقية:

يحدد نقاط الفصل الطبيعية ومراحل التنفيذ
يرتب المهام حسب التبعية (المهام الأساسية أولًا)
يجمع العمليات ذات الصلة معًا
يقدّر نطاق وتعقيد كل مهمة فرعية

توضيح تفاعلي

قد يطرح Verdent أسئلة لتحسين التقسيم:

"هل يجب تعديل التحقق الحالي أم إنشاء أداة تحقق جديدة؟"
"هل تريد تحديث الاختبارات لجميع المكونات المتأثرة؟"
"هل يجب أن ينطبق هذا التغيير على مكونات الويب والجوال معًا؟"

خصائص التقسيم

مهام مصممة لتستغرق 15-45 دقيقة من العمل المركّز
نقاط فصل طبيعية للاختبار والتحقق
معقدة بما يكفي لتكون ذات معنى، وبسيطة بما يكفي للتنفيذ

احترام التبعيات (الإعداد قبل التنفيذ)
تقدم منطقي (طبقة البيانات ← منطق الأعمال ← واجهة المستخدم)
خطوات تحقق بعد المراحل الرئيسية

يمكن تخصيص تنسيق تقسيم الخطة عبر plan_rules.md للتحكم في:

مستوى التفصيل (عام مقابل دقيق)
بنية الخطة وأقسامها
المعلومات المتضمنة (تقديرات الوقت، المخاطر، التبعيات)

مراجعة الخطة والموافقة عليها

بعد إرسال طلب في Plan Mode، يُنشئ Verdent خطة منظمة تُعرض في نافذة المحادثة (Chat View) لمراجعتها.

عملية المراجعة

استلام الخطة المنظمة

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

تحليل جودة الخطة

راجع النقاط التالية:

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

طرح أسئلة توضيحية

اطلب معلومات إضافية إذا كان هناك أي غموض:

Can you explain step 3 in more detail?
Why are we modifying both the service and controller?
What happens if the API call fails in step 5?

طلب تعديلات

قدّم ملاحظات لمراجعة الخطة:

Let's use JWT tokens instead of OAuth2
Can we break step 4 into smaller substeps?
Add error handling considerations to the plan

اختيار الإجراء التالي

بعد أن يُنشئ Verdent الخطة، يُعرض خياران:

تعديل: طلب تعديلات، أو طرح أسئلة توضيحية، أو تحسين الخطة أكثر
بدء البناء: التبديل إلى Agent Mode وبدء تنفيذ الخطة المعتمدة

خيارات التفاعل مع الخطة

بعد مراجعة الخطة المُنشأة، يعرض Verdent خيارين:

تعديل:

اختر هذا الخيار من أجل:

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

يبقيك هذا الخيار في Plan Mode للتحسين التكراري دون تنفيذ أي تغييرات.

بدء البناء:

اختر هذا الخيار من أجل:

التبديل إلى Agent Mode وبدء التنفيذ
تنفيذ الخطة المعتمدة بحرية كاملة
إجراء تعديلات الملفات وتنفيذ الأوامر وفق الخطة

يمكنك أيضًا اختيار:

التنفيذ اليدوي: مراجعة الخطة وتنفيذ التغييرات بنفسك
التنفيذ التدريجي: اطلب من Verdent تنفيذ مراحل محددة مع نقاط تحقق للمراجعة بين المراحل

استخدم تعديل لتحسين الخطة بقدر ما تحتاج من مرات. اختر بدء البناء فقط عندما تكون واثقًا من أن النهج صحيح ومكتمل.

التخطيط التكراري

يمكن للمستخدمين تعديل الخطط وتحسينها بحرية باختيار تعديل وتقديم ملاحظات بلغة محادثة. يتعامل Verdent مع إنشاء الخطط كعملية تفاعلية وتكرارية.

طرق التعديل

طلب تغييرات محددة:

Change step 3 to use Redux instead of Context API
Add input validation before the database insert
Swap the order of steps 4 and 5

إضافة عناصر مفقودة:

Add error handling for network failures
Include rollback procedures
Add performance optimization considerations

تبسيط أو توسيع:

This is too complex - can we simplify the approach?
Break down step 5 into more detailed substeps
Give me more detail on the database schema changes

استكشاف بدائل:

What if we used webhooks instead?
Show me an alternative plan using microservices architecture
Can we accomplish this without changing the database schema?

مثال على تدفق التكرار

User: "Add user authentication to the API"

[Verdent generates initial plan with JWT tokens]

User: "Actually, let's use OAuth2 instead of JWT"

[Verdent revises plan to use OAuth2]

User: "Add step for migrating existing users"

[Verdent adds migration step to plan]

User: "Can you break down the migration step more?"

[Verdent expands migration with detailed substeps]

User: Chooses **Start Building**

[Verdent switches to Agent Mode and begins execution]

تكرارات غير محدودة:

لا يوجد حد لعدد المراجعات
تحافظ كل عملية تكرار على سياق المحادثة
تُحفظ الإصدارات السابقة في سجل المحادثة
يمكنك الرجوع إلى إصدارات سابقة من الخطة: "ارجع إلى النهج الأول"

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

الأسئلة الشائعة

هل يكتب Plan Mode فعليًا أي كود في ملفاتي؟

لا. Plan Mode للقراءة فقط بشكل صارم:

يمكن لـVerdent قراءة الملفات، والبحث في الكود، وتحليل قاعدة الكود لديك
لا تحدث أي كتابة أو تعديل أو حذف للملفات أثناء Plan Mode
تُعرض الخطط في نافذة المحادثة فقط
يبدأ تنفيذ الكود فقط بعد أن توافق صراحة وتنتقل إلى Agent Mode

ضمان الأمان: لا يمكن لـPlan Mode تعديل الكود لديك عن طريق الخطأ. صُمم للاستكشاف الآمن وتطوير الاستراتيجيات.

هل يمكنني تنفيذ خطة بشكل تدريجي بدلاً من دفعة واحدة؟

نعم. التنفيذ التدريجي مدعوم بالكامل:

نمط الموافقة التدريجية:

Let's start with Phase 1 first, then we'll review before continuing
Implement steps 1-3, then stop for review
Do the database migration first, I'll review before the API changes

كيف يعمل:

ينفّذ Verdent الخطوات المحددة
يتوقف عند نقطة تحقق للمراجعة
تراجع النتائج وتقدّم ملاحظاتك
تابع إلى المرحلة التالية أو عدّل النهج
كرّر حتى الاكتمال

الأنسب لـ: التغييرات عالية المخاطر، الأنماط غير المألوفة، الكود بالغ الأهمية في الإنتاج حيث يقلل الطرح المرحلي من المخاطر.

يتيح لك التنفيذ التدريجي الموافقة على أجزاء من الخطة مع تأجيل أجزاء أخرى، وهو مفيد عند تغيّر الأولويات في منتصف المهمة.

ماذا يحدث إذا رفضت خطة؟

رفض الخطة أمر طبيعي ومتوقع تمامًا:

يُنشئ Verdent خطة جديدة بناءً على ملاحظاتك
تبقى إصدارات الخطة السابقة في سجل المحادثة للرجوع إليها
لا تحدث أي تغييرات في الكود (لأن Plan Mode للقراءة فقط)
يمكنك التكرار عددًا غير محدود من المرات حتى تصل إلى الرضا

أسباب رفض شائعة:

النهج معقد جدًا أو بسيط جدًا
حالات حدّية أو معالجة أخطاء مفقودة
وجود بنية بديلة أفضل
سوء فهم للمتطلبات

نصيحة: الرفض جزء من العملية. من الأفضل تحسين الخطط تكراريًا بدلًا من إهدار الجهد في تنفيذ استراتيجيات غير صحيحة.

كيف أتنقل بين Plan Mode وAgent Mode؟

التبديل فوري عبر مربع الإدخال:

للدخول إلى Plan Mode:

انقر على زر Switch Mode في مربع الإدخال
حدد Plan Mode من القائمة المنسدلة
أو قل: "التبديل إلى Plan Mode"

للخروج من Plan Mode:

انقر على زر Switch Mode في مربع الإدخال
حدد Agent Mode من القائمة المنسدلة
أو اختر بدء البناء بعد مراجعة خطة

استمرارية الوضع:

يستمر اختيار الوضع ضمن الجلسة الحالية
تبدأ الجلسات الجديدة في Agent Mode الافتراضي
يمكنك التبديل بين الأوضاع بحرية في أي وقت

سير عمل نموذجي: Plan Mode ← مراجعة ← Agent Mode ← تنفيذ ← العودة إلى Plan Mode لميزة معقدة تالية.

هل يمكنني تخصيص تنسيق ومستوى تفصيل الخطط المُنشأة؟

نعم، باستخدام plan_rules.md:

الموقع: ~/.verdent/plan_rules.md (دليل التكوين العام)

ما يمكنك تخصيصه:

مستوى التفصيل: نظرة عامة عالية المستوى مقابل خطوات دقيقة تفصيلية
بنية الخطة: الأقسام المطلوب تضمينها (ملخص، مخاطر، تبعيات، اختبار)
المعلومات المتضمنة: تقديرات الوقت، مسارات الملفات، خطوات التحقق
تفضيلات التنسيق: قوائم مرقّمة، مراحل، تصنيف

مثال على plan_rules.md:

# Plan Rules

## Plan Structure
- Start with a brief summary (2-3 sentences)
- Include estimated time for each major step
- List prerequisites before implementation steps
- Identify potential risks and mitigation strategies

## Level of Detail
- Break tasks into subtasks of 15-30 minutes
- Include specific file paths for modifications
- List functions or components to create/modify
- Provide verification steps for each phase

تُطبَّق التغييرات فورًا على جلسات Plan Mode الجديدة.

هل يستخدم Plan Mode نفس سياق Agent Mode؟

لا، لدى Plan Mode إدارة سياق منفصلة:

سياق Plan Mode: مُحسَّن للتحليل والتفكير الاستراتيجي
سياق Agent Mode: مُحسَّن للتنفيذ والتطبيق
الفائدة: لا تلوّث الخطط سياق التنفيذ بالبحث الاستكشافي

لماذا يهم الفصل:

يمكن لـPlan Mode استكشاف عدة نهج دون إثقال Agent Mode
محاولات الخطط المرفوضة لا تستهلك سياق Agent Mode
بداية نظيفة عند التبديل إلى التنفيذ

إعادة ضبط السياق: يوفر تبديل الأوضاع سياقًا جديدًا لنوع المهمة الجديد.

ماذا لو طرح Verdent أسئلة توضيحية أثناء التخطيط؟

الأسئلة التوضيحية جزء من عملية التقسيم:

لماذا تُطرح الأسئلة:

المتطلبات الغامضة تحتاج إلى توضيح
وجود عدة نهج صالحة (يجب اختيار واحد)
حالات حدّية أو قيود لم تُحدد بعد
تفضيلات غير واضحة من الطلب الأولي

كيفية الرد:

أجب مباشرة بلغة محادثة
قدّم أمثلة إن كان ذلك مفيدًا
قل "اختر أنت" إذا كنت تثق بحكم Verdent
اطرح أسئلة مضادة إذا لم تكن متأكدًا

مثال على تبادل:

Verdent: "Should I modify the existing validation or create a new validator?"
You: "Create a new validator - we'll deprecate the old one later"
Verdent: [Updates plan with new validator approach]

نصيحة: تساعد الأسئلة Verdent على إنشاء خطط دقيقة وملائمة مصممة خصيصًا لاحتياجاتك.