جودة الشفرة المُنشأة تعتمد كلياً تقريباً على ما تطلبه وكيف تطلبه ويشمل هذا الدليل الأنماط التي تنتج باستمرار نتائج أفضل مع Claude Code.
ومن تحديد نطاق المهام إلى النظام يحفز، من الصقل المتكرر إلى التعليمات الخاصة بالدور. التقنيات العملية يمكنك تطبيقها في جلسة الترميز القادمة.
عندما تطلبين من مطور بشري أن يبنوا صفحة دخول، يسألون أسئلة توضيحية: أيّ مُقدّم في ذلك الوقت؟ أي حقول؟ هل يتعامل مع (أوث)؟ رسائل خاطئة؟ الولايات المتحدة؟?
وكلاء الترميز سيحاولون الإجابة على كل هذه الأسئلة بأنفسهم أحياناً يخمنون الصواب غالباً ما يخمنون شيئاً معقولاً لكن ليس ما أردته الثغرة بين "معقلة" و"صحيحة تماماً" هي ما يقترب من الهندسة السريعة.
العجلات الجيدة لا تحتاج أن تكون طويلة. يجب أن يكونوا محددين بشأن الأمور التي تهم و صامتة بشأن الأشياء التي لا تهمهم هذا التوازن هو ما يدور حوله هذا الدليل.
أنماط تحسن النتائج بصرف النظر عن المهمة.
وبدلاً من إنشاء عنصر ردة فعل، ثم إضافة الدولة، ثم وضع الصفات، ووصف النتيجة النهائية: دع العميل يقرر كيفية الوصول إلى هناك.
Avoid
إنشاء عنصر. أضف دولة الاستخدام أضف زراً للهز صفقه مع (تيلويند).
Better
بناء عنصر جانبي قابل للانهيار يُدرج المشاريع بالاسم. It should support drag-to-reorder and match our dark theme (bg-[111318], border-[262b38]). يجب أن تستمر الولاية الملتوية عبر الصفحات.
عملاء أفضل عندما يعرفون الحدود حددي أي ملفات ستلمسها أو تتفادى أي أنماط يجب اتباعها وما يبدو عليه وتؤدي المهام غير المقيدة إلى تصاعد التغييرات التي يصعب استعراضها.
Avoid
راجع نظام التوثيق.
Better
قم بتثبيط معالج الشعارات في القوس/القطعة/اللوائح لاستخدام البكر بدلاً من الشاشة 256 لتسريع كلمة السر لا تُغيّرْ منطقَ JWT أَو مناولةِ كعكةِ الدورةِ. Update the related tests in tests/auth/.
يمكن لـ (إكس جيه LOS23X1XGLOS) قراءة ملفات مشروعك، ولكن لا يمكن قراءة عقلك. إذا كان هناك إتفاقية تتابعها، مكتبة تفضلها، أو نمط قد وضعته بالفعل، قل ذلك. هذا ينقذ إعادة العمل.
Avoid
مصادقة النموذج.
Better
أضف استمارة التحقق إلى استمارة الإشارة باستخدام حديقة الحيوان (نستخدمها بالفعل في شكل العوارض في القوس/الشكل/المواقف). تظهر رسائل خاطئة تحت كل حقل اتبع نفس الخطأ الذي يصف شكل الشعار.
العجلات المكمّلة (أبنوا الـ (آي بي آي) و اكتبوا الفحوصات و استكملوا الأطباء و نشروا) اكسر العمل المعقد في مهام متتابعة ومركزة. كل واحد يعتمد على النتيجة السابقة.
Avoid
بناء صفحة بيانات المستخدمين، وكتابة نقاط النهاية، وإضافات الاختبارات، وتحديث نظام README، وتصليح بار الناف بينما كنت في ذلك.
Better
(ب) بناء نقطة النهاية (GET)/api/user/profile. عودوا، الاسم، البريد الإلكتروني، وميادين الخطة. إستخدموا الإطارات المتوسطة الموجودة للتوثيق.
إذا كانت النتيجة الأولى غير صحيحة، صقل السرعة بدلا من البدء من جديد. Claude retains the full conversation context. قل ما هو الخطأ، ما تغيير، وما للحفاظ. الإرتداد أسرع من إعادة الإختراع.
Avoid
هذا خطأ ابدأ من جديد وبناء المكوّن بشكل مختلف.
Better
التصميم جيد لكن نقطة التفتيش المتحركة خاطئة أسفل 768 ×، حزم البطاقات عموديا بدلا من استخدام شبكة. أبقي كل شيء آخر كما هو.
النظام يحفز سلوك خط الأساس لوكيل قبل أن تقول أي شيء إنها أكثر الأدوات استخداماً في الترميز.
أي نظام يُخبرُ الوكيل الذي هو، الذي يَجِبُ أَنْ يُركّزَ على، وما هو يَجِبُ أَنْ يَتفادى. وهو ينطبق على كل رسالة في الدورة. فكّر به كوصف عمل العميل.
AgentsRoom ships with 14 role-specific system prompts: one for each agent type. عميل "الجبهة" يُخبره أن يركز على المكونات، الوصول، التصميم المستجيب. وكيل الـ"كيو أي" يخبره أن يفكر في قضايا الحافة ويكتب اختبارات شاملة يمكنك تكييف هذه أو كتابة الخاص بك.
أنتِ مطورة عليا Focus on React components, CSS/Tailwind styling, accessibility (WCAG AA), and responsive design. استخدم مكتبة المكوّنات الحالية للمشروع قبل إنشاء مكونات جديدة التكوين الأفضل على الميراث اكتب سائل مغناطيسي لا تعدل الملفات الخلفية.
العجلة الأكثر فعالية ليست مصممة في الدردشة إنه يعيش في مستودعك.
CLAUDE.md هو ملف علامة أسفل على أساس مشروعك أن Claude Code يقرأ تلقائيا. وهو يتضمن هيكل المشاريع، والاتفاقيات، وتفاصيل الحزم، والمبادئ التوجيهية التي تنطبق على كل دورة من دورات العناصر في المشروع.
بدلاً من تكرار 'نحن نستخدم تيلويند CSS 4، بريزما ORM، والتالي. كل عميل يرث هذا السياق AgentsRoom تشمل محررا مبنيا ل CLAUDE.md حتى تتمكن من تحديثه دون ترك التطبيق.
الـ (كلودي) مصممة جيداً تساوي أكثر من عشرات العجلات الفردية المصممة بعناية It compounds: every session benefits from it.
توقف عن كتابة نفس التعليمات انقذوا ما يفلح وأعيدوا استخدامه.
إذا وجدت نفسك تكتب نفس نوع الطلب عبر المشاريع (أكتب اختبارات الوحدة لهذا الملف، 'مفاعل هذا لاستعمال نمط المستودع '، "الخطأ في التعامل مع جميع مسارات API"، وإنقاذ ذلك على أنه سريع إعادة الاستخدام.
ويشمل AgentsRoom سمة مكتبية سريعة ذات مستويين: عجلات كل مشروع للمهام الخاصة بالمشروع، وعجلات عالمية )متجمعة( لأنماط تستخدمها في كل مكان.
المرشحون الجيدون لدوافع المكتبة: قوائم مرجعية لاستعراض الرموز، ونماذج كتابة الاختبارات، ونصوص الهجرة، وتعليمات تجميع العناصر، وخطوات مراجعة الحسابات الأمنية. أي شيء كنت وضعت في فريق ويكي كإجراء عادي.
اكتب اختبارات للوحدة استعملي اليقظة تغطية المسار السعيد، والحالات الحافة (المساهمة المفرغة، واللاغية، والأنواع غير الصحيحة)، ومعالجة الأخطاء. معالين خارجيين صوبوا 90% من التغطية.
Review the changes in the current git diff. التحقق من: الواردات غير المستخدمة، ومناولة الأخطاء المفقودة، والمسائل المتعلقة بالسلامة من النوع، والظروف العرقية المحتملة، والتناقضات السمية. افترض ان كل قضية وجدت.
Create a REST endpoint for [resource]. Include input validation with zod, proper error responses (400, 401, 404, 500), TypeScript types for request/response, and a JSDoc comment describing the endpoint. اتبع النمط الحالي في القوس/الباب/.
التقنيات المتعلقة بالمهام المعقدة التي تتجاوز مسارات واحدة.
اكسر مهمه كبيره الى خطوات امر بها ابدأوا بالعامل الأول بالخطوة الأولى، وانتظروا للإنجاز، ثم ابدأوا بالعامل التالي بالخطوة الثانية (الإشارة إلى ناتج الخطوة الأولى). وكل خطوة أصغر وأكثر تركيزا. العميل 1 يصمم شيما قاعدة البيانات العميل 2 يكتب الـ (آي بي آي) باستخدام هذا الكيماوي.
بعد أن ينتهي عميل واحد، نوجه عميلاً مختلفاً في ناتجه. 'استعراض التغييرات التي قام بها وكيل الجبهة للتو في Src/components/. تحقق من مشاكل الوصول و حالات الخطأ المفقودة عميل جديد ذو دور مختلف يمسك الأشياء التي فاتها العميل الأصلي.
ابدئي بسرعه طليقة لمعرفة كيف يقترب العميل من المشكلة ثم إضافة قيود في رسائل المتابعة: "هيكل جيد، ولكن استخدام مكونات الخواديم بدلا من مكونات العملاء." "ابق الخطاف، لكن ازيل الطعم واستخدم طفح "ريك كوري" بدلاً من ذلك كل تردد يضيق نحو الحل الذي تريده.
نقطة الوكيل في الرمز الحالي: "Build a settings page following the same pattern as src/pages/profile.tsx. نفس الهيكل التخطيطي، نفس الشكل من المناولة، نفس عرض الخطأ وكثيرا ما يكون ذلك أكثر فعالية من وصف النمط بالكلمات.
النباتات التي تنتج باستمرار نتائج أسوأ.
بإخبار العميل بالضبط ما الذي يعمل على الكتابة، أي متغيرات تُسمّى، وأيّ أمر لتنفيذ الأشياء. هذه الإدارة الدقيقة تزيل قدرة العميل على إيجاد نهج أفضل صف النتيجة وليس الإجراء.
أطلب من عميل أن ينقذ القاعدة بدون قيود بدون حدود، قد يصلح العميل الملفات التي لم ترغب في لمسها، ويغيّر الرقم القياسي الذي يعتمد عليه الرمز الآخر، أو ينفق على التحسينات ذات الأولوية المنخفضة.
Not mentioning that a pattern, utility, or component already exists in the project. الوكيل سيخلق واحد جديد بسيط "نحن بالفعل لدينا خطاف في القوس والهراء".
تحطيم خمس مهام في رسالة واحدة الوكيل سيحاول كلّهم، لكنّ النوعية تسقط بينما يُنظّفُ الأهداف المُنافسة. وبدلاً من ذلك، فصلهم إلى طلبات متتابعة ومركزة.
(إكس جيه LOS95XGLOS) تعطيك عجلات نظامية، مكتبة سريعة، تحرير (كلاود) القليل من وقت الصنع، المزيد من الوقت.
التطبيق المرافق: تابع وكلاءك أينما كنت
استخدم Claude أو Codex أو Antigravity CLI أو أي مزود AI آخر.
أرسل الأخطاء والطلبات مباشرة إلى قائمة المهام العامة.
لمحة عن AgentsRoom أثناء العمل.