جودة الشفرة المُنشأة تعتمد كلياً تقريباً على ما تطلبه وكيف تطلبه ويشمل هذا الدليل الأنماط التي تنتج باستمرار نتائج أفضل مع Claude Code.
ومن تحديد نطاق المهام إلى النظام يحفز، من الصقل المتكرر إلى التعليمات الخاصة بالدور. التقنيات العملية يمكنك تطبيقها في جلسة الترميز القادمة.
عندما تطلبين من مطور بشري أن يبنوا صفحة دخول، يسألون أسئلة توضيحية: أيّ مُقدّم في ذلك الوقت؟ أي حقول؟ هل يتعامل مع (أوث)؟ رسائل خاطئة؟ الولايات المتحدة؟
وكلاء الترميز سيحاولون الإجابة على كل هذه الأسئلة بأنفسهم أحياناً يخمنون الصواب غالباً ما يخمنون شيئاً معقولاً لكن ليس ما أردته الثغرة بين "معقلة" و"صحيحة تماماً" هي ما يقترب من الهندسة السريعة.
العجلات الجيدة لا تحتاج أن تكون طويلة. يجب أن يكونوا محددين بشأن الأمور التي تهم و صامتة بشأن الأشياء التي لا تهمهم هذا التوازن هو ما يدور حوله هذا الدليل.
أنماط تحسن النتائج بصرف النظر عن المهمة.
بدلاً من قول «أنشئ مكوّن React، ثم أضف الحالة، ثم أضف التنسيق»، صِف النتيجة النهائية: «أنشئ شريطاً جانبياً قابلاً للطي يعرض أسماء المشاريع، ويدعم إعادة الترتيب بالسحب، ويستخدم سِمة Tailwind الحالية لدينا». ودع الوكيل يقرر كيف يصل إلى ذلك.
Avoid
أنشئ مكوّناً. أضف useState. أضف زر تبديل. نسّقه بـ Tailwind.
Better
أنشئ مكوّن شريط جانبي قابل للطي يعرض المشاريع بالاسم. يجب أن يدعم إعادة الترتيب بالسحب وأن يطابق سِمتنا الداكنة (bg-[#111318], border-[#262b38]). ويجب أن تبقى حالة الطي محفوظة بعد إعادة تحميل الصفحة.
عملاء أفضل عندما يعرفون الحدود حددي أي ملفات ستلمسها أو تتفادى أي أنماط يجب اتباعها وما يبدو عليه وتؤدي المهام غير المقيدة إلى تصاعد التغييرات التي يصعب استعراضها.
Avoid
راجع نظام التوثيق.
Better
أعد هيكلة معالج تسجيل الدخول في src/api/auth/login.ts لاستخدام bcrypt بدلاً من sha256 في تجزئة كلمات المرور. لا تغيّر منطق JWT ولا معالجة كوكي الجلسة. وحدّث الاختبارات المرتبطة في tests/auth/.
يمكن لـ Claude Code قراءة ملفات مشروعك، لكنه لا يستطيع قراءة عقلك. إذا كان هناك اتفاقية تتبعها، مكتبة تفضلها، أو نمط قد أنشأته بالفعل، فقل ذلك. هذا يوفر إعادة العمل.
Avoid
مصادقة النموذج.
Better
أضف استمارة التحقق إلى استمارة الإشارة باستخدام حديقة الحيوان (نستخدمها بالفعل في شكل العوارض في القوس/الشكل/المواقف). تظهر رسائل خاطئة تحت كل حقل اتبع نفس الخطأ الذي يصف شكل الشعار.
العجلات المكمّلة (أبنوا الـ (آي بي آي) و اكتبوا الفحوصات و استكملوا الأطباء و نشروا) اكسر العمل المعقد في مهام متتابعة ومركزة. كل واحد يعتمد على النتيجة السابقة.
Avoid
بناء صفحة بيانات المستخدمين، وكتابة نقاط النهاية، وإضافات الاختبارات، وتحديث نظام README، وتصليح بار الناف بينما كنت في ذلك.
Better
(ب) بناء نقطة النهاية (GET)/api/user/profile. عودوا، الاسم، البريد الإلكتروني، وميادين الخطة. إستخدموا الإطارات المتوسطة الموجودة للتوثيق.
إذا لم تكن النتيجة الأولى صحيحة، حسّن المطالبة بدلاً من البدء من الصفر. يحتفظ Claude بسياق المحادثة كاملاً. قل ما هو الخطأ، وما الذي يجب تغييره، وما الذي يجب الإبقاء عليه. التكرار أسرع من إعادة الاختراع.
Avoid
هذا خطأ ابدأ من جديد وبناء المكوّن بشكل مختلف.
Better
التصميم جيد لكن نقطة التفتيش المتحركة خاطئة أسفل 768 ×، حزم البطاقات عموديا بدلا من استخدام شبكة. أبقي كل شيء آخر كما هو.
النظام يحفز سلوك خط الأساس لوكيل قبل أن تقول أي شيء إنها أكثر الأدوات استخداماً في الترميز.
أي نظام يُخبرُ الوكيل الذي هو، الذي يَجِبُ أَنْ يُركّزَ على، وما هو يَجِبُ أَنْ يَتفادى. وهو ينطبق على كل رسالة في الدورة. فكّر به كوصف عمل العميل.
يأتي AgentsRoom مع 14 مطالبة نظام مخصصة للأدوار: واحدة لكل نوع من الوكلاء. تطلب مطالبة وكيل Frontend التركيز على المكونات وإمكانية الوصول والتصميم المتجاوب، بينما تطلب مطالبة وكيل QA التفكير في الحالات الحدية وكتابة اختبارات شاملة. ويمكنك تعديلها أو كتابة مطالباتك الخاصة.
أنتِ مطورة عليا Focus on React components, CSS/Tailwind styling, accessibility (WCAG AA), and responsive design. استخدم مكتبة المكوّنات الحالية للمشروع قبل إنشاء مكونات جديدة التكوين الأفضل على الميراث اكتب سائل مغناطيسي لا تعدل الملفات الخلفية.
العجلة الأكثر فعالية ليست مصممة في الدردشة إنه يعيش في مستودعك.
CLAUDE.md هو ملف علامة أسفل على أساس مشروعك أن Claude Code يقرأ تلقائيا. وهو يتضمن هيكل المشاريع، والاتفاقيات، وتفاصيل الحزم، والمبادئ التوجيهية التي تنطبق على كل دورة من دورات العناصر في المشروع.
بدلاً من تكرار «نحن نستخدم Tailwind CSS 4 وPrisma ORM وNext.js 16» في كل محادثة، اكتبها مرة واحدة في CLAUDE.md. يرث كل وكيل هذا السياق. ويتضمن AgentsRoom محرراً مدمجاً لملف CLAUDE.md حتى تتمكن من تحديثه دون مغادرة التطبيق.
ملف CLAUDE.md مكتوب جيداً يساوي أكثر من عشرات المطالبات الفردية المصاغة بعناية. أثره تراكمي: كل جلسة تستفيد منه.
توقف عن كتابة نفس التعليمات انقذوا ما يفلح وأعيدوا استخدامه.
إذا وجدت نفسك تكتب نفس نوع الطلب عبر المشاريع (أكتب اختبارات الوحدة لهذا الملف، 'مفاعل هذا لاستعمال نمط المستودع '، "الخطأ في التعامل مع جميع مسارات API"، وإنقاذ ذلك على أنه سريع إعادة الاستخدام.
ويشمل AgentsRoom سمة مكتبية سريعة ذات مستويين: عجلات كل مشروع للمهام الخاصة بالمشروع، وعجلات عالمية )متجمعة( لأنماط تستخدمها في كل مكان.
المرشحون الجيدون لدوافع المكتبة: قوائم مرجعية لاستعراض الرموز، ونماذج كتابة الاختبارات، ونصوص الهجرة، وتعليمات تجميع العناصر، وخطوات مراجعة الحسابات الأمنية. أي شيء كنت وضعت في فريق ويكي كإجراء عادي.
اكتب اختبارات للوحدة استعملي اليقظة تغطية المسار السعيد، والحالات الحافة (المساهمة المفرغة، واللاغية، والأنواع غير الصحيحة)، ومعالجة الأخطاء. معالين خارجيين صوبوا 90% من التغطية.
راجع التغييرات في git diff الحالي. تحقق من: الاستيرادات غير المستخدمة، ومعالجة الأخطاء المفقودة، ومشكلات أمان الأنواع، وحالات التسابق المحتملة، وتضارب التسميات. واقترح إصلاحاً لكل مشكلة تجدها.
أنشئ نقطة نهاية REST لـ [resource]. أضف التحقق من المدخلات باستخدام zod، واستجابات أخطاء مناسبة (400, 401, 404, 500)، وأنواع TypeScript للطلب والاستجابة، وتعليق JSDoc يصف نقطة النهاية. واتبع النمط الحالي في src/api/.
التقنيات المتعلقة بالمهام المعقدة التي تتجاوز مسارات واحدة.
اكسر مهمه كبيره الى خطوات امر بها ابدأوا بالعامل الأول بالخطوة الأولى، وانتظروا للإنجاز، ثم ابدأوا بالعامل التالي بالخطوة الثانية (الإشارة إلى ناتج الخطوة الأولى). وكل خطوة أصغر وأكثر تركيزا. العميل 1 يصمم شيما قاعدة البيانات العميل 2 يكتب الـ (آي بي آي) باستخدام هذا الكيماوي.
بعد أن ينتهي وكيل، وجّه وكيلاً آخر إلى ناتجه. «راجع التغييرات التي أجراها وكيل Frontend للتو في src/components/. تحقق من مشكلات إمكانية الوصول وحالات الخطأ الناقصة». وكيل جديد بدور مختلف يلتقط ما فات الوكيل الأصلي.
ابدئي بسرعه طليقة لمعرفة كيف يقترب العميل من المشكلة ثم إضافة قيود في رسائل المتابعة: "هيكل جيد، ولكن استخدام مكونات الخواديم بدلا من مكونات العملاء." "ابق الخطاف، لكن ازيل الطعم واستخدم طفح "ريك كوري" بدلاً من ذلك كل تردد يضيق نحو الحل الذي تريده.
وجّه الوكيل إلى كود موجود بالفعل: "أنشئ صفحة إعدادات بنفس نمط src/pages/profile.tsx: نفس بنية التخطيط، ونفس معالجة النماذج، ونفس طريقة عرض الأخطاء." غالباً ما يكون هذا أكثر فعالية من وصف النمط بالكلمات.
النباتات التي تنتج باستمرار نتائج أسوأ.
بإخبار العميل بالضبط ما الذي يعمل على الكتابة، أي متغيرات تُسمّى، وأيّ أمر لتنفيذ الأشياء. هذه الإدارة الدقيقة تزيل قدرة العميل على إيجاد نهج أفضل صف النتيجة وليس الإجراء.
أطلب من عميل أن ينقذ القاعدة بدون قيود بدون حدود، قد يصلح العميل الملفات التي لم ترغب في لمسها، ويغيّر الرقم القياسي الذي يعتمد عليه الرمز الآخر، أو ينفق على التحسينات ذات الأولوية المنخفضة.
عدم الإشارة إلى أن نمطاً أو أداة مساعدة أو مكوّناً موجود بالفعل في المشروع، فينشئ الوكيل نسخة جديدة منه. جملة بسيطة مثل "لدينا بالفعل خطاف useAuth في src/hooks/" توفّر الكثير من إعادة العمل.
تحطيم خمس مهام في رسالة واحدة الوكيل سيحاول كلّهم، لكنّ النوعية تسقط بينما يُنظّفُ الأهداف المُنافسة. وبدلاً من ذلك، فصلهم إلى طلبات متتابعة ومركزة.
البرمجة لم تعد هي العائق، التواصل هو الأصل. كيف تتحدث مع وكلاء الذكاء الاصطناعي Claude و Codex و Antigravity و Grok Build لتشحن أسرع، بدقة أعلى، وبتكلفة توكنز أقل.
تمرير ملفات PDF مباشرة إلى Claude أو أي نموذج لغوي يستهلك التوكنات بصمت: كل صفحة تتحول أيضًا إلى صورة. حوّل الملف إلى Markdown أولًا باستخدام MarkItDown، أداة Microsoft المجانية مفتوحة المصدر، واخفض فاتورة التوكنات بنسبة تصل إلى 80%. دليل كامل مع CLI وPython وإعداد MCP.
يوفر لك AgentsRoom تعليمات النظام، ومكتبة تعليمات، وتحرير CLAUDE.md مدمج. وقت أقل في صياغة التعليمات، ووقت أكثر في البناء.
التطبيق المرافق: تابع وكلاءك أينما كنت
استخدم Claude أو Codex أو Antigravity CLI أو أي مزود AI آخر.
أرسل الأخطاء والطلبات مباشرة إلى قائمة المهام العامة.
لمحة عن AgentsRoom أثناء العمل.