العمل مع قواعد الكود الكبيرة

اطرح أسئلة استكشاف عامة

Where is user authentication handled in this codebase?

يفوّض Verdent المهمة تلقائيًا إلى وكيل Explorer، وهو متخصص فعّال من حيث استهلاك الرموز في عمليات البحث داخل قاعدة الكود.

يبحث Explorer بكفاءة

يقوم وكيل Explorer بما يلي:

• البحث في أسماء الملفات والمسارات
• فحص محتوى الكود بحثًا عن الكلمات المفتاحية
• تحليل الأنماط المعمارية
• إعادة النتائج مع مسارات الملفات ومقتطفات الكود

نقّح عملية البحث

Show me all files that import the authentication module

يمكن لـ Explorer إجراء عمليات بحث تكميلية لتضييق نطاق النتائج.

نفّذ عمليات بحث معقدة بشكل متوازٍ

من أجل استكشاف شامل، يمكن لـ Verdent تشغيل عدة وكلاء Explorer بشكل متوازٍ:

• Explorer 1: إيجاد منطق المصادقة (authentication)
• Explorer 2: إيجاد منطق التفويض (authorization)
• Explorer 3: إيجاد إدارة الجلسات

تصل النتائج بشكل أسرع من خلال البحث المتوازي.

حدد الحدود الطبيعية للمهام

بدلًا من طلب كل شيء دفعة واحدة:

Phase 1: Add the data models for the notification system

ركّز أولًا على مكون واحد قائم بذاته.

أكمل المرحلة بالكامل

اعمل على المرحلة الأولى بالكامل، بما في ذلك الاختبار، قبل الانتقال إلى المرحلة الثانية. هذا ينشئ نقطة تحقق نظيفة.

احفظ تقدمك (Commit)

git add .
git commit -m "feat: add notification data models"

يوفر الـ commit نقطة تراجع آمنة.

أفرغ السياق للمرحلة التالية

بالنسبة للمهام المعقدة، أفرغ السياق قبل الانتقال إلى المرحلة التالية. هذا يضمن أن يتوفر لدى Verdent سعة سياق كافية للحفاظ على أعلى أداء.

Phase 2: Build the notification API endpoints using the data models

ابدأ جلسة جديدة بسياق نظيف يركّز فقط على المرحلة الثانية.

ابدأ في Plan Mode

Switch to Plan Mode: Refactor the payment processing logic to use a new payment provider across all files

يتيح Plan Mode تحليلًا للقراءة فقط دون استهلاك السياق في تعديل الملفات.

استخدم Explorer لإيجاد جميع الملفات المتأثرة

Use the Explorer agent to find all files that reference payment processing

يضمن اكتشافك لكل موقع يحتاج إلى تحديث.

راجع الخطة الشاملة

يعرض Verdent خطة تُظهر:

• جميع الملفات التي تتطلب تغييرات (تم تحديد 25 ملفًا)
• الحد الأدنى من الملفات التي يجب تضمينها في السياق الرئيسي
• ترتيب العمليات
• التبعيات بين التغييرات

راجع الخطة قبل الالتزام بالنهج.

اعتمد التنفيذ

بعد أن تكون راضيًا عن الخطة، اعتمد التنفيذ. يعمل Verdent على إجراء التغييرات بشكل منهجي.

استخدم Explorer لإيجاد جميع الاستخدامات

Use the Explorer agent to find all files that use the calculateTotal function

يحدد كل ملف يحتاج إلى تحديث.

راجع النطاق في Plan Mode

In Plan Mode: Rename calculateTotal to computeFinalTotal across all files

شاهد النطاق الكامل قبل إجراء التغييرات.

تحقق من عدم تفويت أي ملفات

يعرض Verdent جميع الـ52 ملفًا التي تتطلب تحديثًا. راجع القائمة للتأكد من الاكتمال.

نفّذ التغييرات المنسّقة

اعتمد الخطة. يقوم Verdent بتحديث جميع الملفات بشكل منهجي، مما يضمن إعادة تسمية متسقة في كل مكان.

شغّل الاختبارات للتحقق

Run the full test suite to verify all references were updated correctly

تكشف الاختبارات أي مراجع تم تفويتها.