استخدم هذه الخطوات كقائمة تحقق عملية، وكيّفها مع أدلة المشروع ونطاقه وقيوده.
السياق والنطاق
- اقرأ تعليمات المشروع المنطبقة على هذه الأداة إن وُجدت (مثل .cursor/rules أو CLAUDE.md)؛ وراجع README وملف البيان عند توفرهما.
- قبل التعديل، لخّص البنية الحالية وحدد الملفات التي يتطلبها هذا التغيير فقط.
- صغ الهدف كنتيجة واحدة قابلة للتحقق؛ ولا توسّع المهمة بلا سبب.
- قبل تغيير API، حدّد الجهات التي تستخدمه وشكل الطلب والاستجابة ومتطلبات التوافق.
الجودة والسلامة
- حدّد تنسيق كل إدخال من المستخدم وطوله وطريقة التحقق من القيم غير الآمنة.
- لا تضع الأسرار مطلقًا في الشيفرة أو السجلات أو ملفات fixtures أو الأمثلة أو أصول الواجهة الأمامية المنشورة.
- في صفحات البحث، افحص title وdescription وcanonical وrobots والعناوين والروابط وHTML المصدر.
- احتفظ بنص مستقل لكل لغة، وبأمثلة اتصال ملائمة للمنطقة، وبعناوين URL مكافئة.
- اجعل العناصر التفاعلية قابلة للاستخدام بلوحة المفاتيح، وامنحها أسماء مفهومة للتقنيات المساعدة، وأظهر حالة التركيز بوضوح.
التحقق وإعداد التقارير
- شغّل الفحوص التي تدعم السلوك الذي تغيّر فقط؛ ولا تدّع تنفيذ أوامر لم تشغّلها.
- قارن معايير القبول بالنتيجة، وافحص مسارات الخطأ وعرض الهاتف المحمول.
- أبلغ عن التغييرات والأوامر ونتائجها الفعلية والقيود المعروفة وطريقة التراجع.