إعداد ملف Claude.md الخاص بك يجعل البرمجة بالذكاء الاصطناعي أبطأ بنسبة 99%
원제 · This Is Why Claude Code Fails In AI Coding
핵심 요약
يعتمد نجاح وكلاء البرمجة بالذكاء الاصطناعي على هيكلة ملف claud.md بذكاء، من خلال إدراج تعليمات التفكير المسبق، وتحديد أهداف قابلة للتحقق، والالتزام بحد أقصى يبلغ 300 سطر لضمان أداء مستقر وعالي الجودة.
하이라이트
تعد إضافة تعليمات التفكير المسبق في ملف claud.md خطوة تقلل بشكل كبير من الحاجة إلى تصحيح المسار أثناء عمل وكيل الذكاء الاصطناعي.
يؤدي الالتزام بحد أقصى قدره 300 سطر في ملف القواعد إلى الحفاظ على أداء الوكيل الأمثل ومنع التدهور في الأداء.
يجب إعطاء الأولوية في ترتيب التعليمات داخل الملف، حيث توضع القواعد الصارمة وغير القابلة للتفاوض في البداية.
تساهم إضافة اختبارات قابلة للتحقق لكل مهمة في توجيه الوكيل نحو النتائج الصحيحة بدلاً من التخمين العشوائي.
تمنع ملفات القواعد ذات النطاق المحدود (path-scoped) تضخم السياق وتسمح للوكيل بالتركيز على مهام محددة داخل أجزاء معينة من المشروع.
타임라인
أساسيات ملف claud.md
لا يكفي تشغيل أمر التهيئة البسيط للحصول على أداء جيد. يتطلب الأمر نمطاً منظماً ومخصصاً للمشروع. يقلل إجبار الوكيل على التفكير بوضوح قبل التنفيذ من الحاجة إلى تصحيح الأخطاء لاحقاً ويضمن توافق المخرجات مع رغبة المستخدم.
- يعد ملف claud.md أو agents.md المحدد الأساسي لجودة تنفيذ الوكيل للمهام.
- يجب إضافة تعليمات صريحة تلزم Claude بالتفكير قبل البرمجة لتوضيح الافتراضات.
مبادئ البساطة والتنفيذ الجراحي
يميل الوكلاء أحياناً إلى الإفراط في التعقيد أو تغيير أجزاء غير ضرورية من الكود. يساعد وضع قيود صارمة داخل ملف القواعد على إيقاف هذه السلوكيات، مما يحافظ على تركيز الوكيل على المهمة الأصلية المطلوبة منه فقط.
- يقلل توجيه الوكيل نحو البساطة من استهلاك التوكنز ويجعل الكود أسهل في إعادة الهيكلة.
- يجب تقييد الوكيل لتنفيذ التغييرات في الأجزاء المطلوبة فقط دون محاولة تحسين الكود المحيط غير المرتبط بالمهمة.
التنفيذ القائم على الأهداف والتحقق
بدلاً من كتابة كود فقط، يجب تكليف الوكيل بتحويل المهام إلى أهداف قابلة للتحقق عبر حالات اختبار. يساعد هذا النهج في التأكد من أن الكود المنتج لا يعمل فقط كبنية، بل يؤدي الوظيفة المطلوبة بدقة.
- يتحول أداء الوكيل إلى الأفضل عندما يعرف معايير النجاح المحددة لكل مهمة.
- يمكن ربط أدوات خارجية مثل Puppeteer MCP لتمكين الوكيل من التحقق بصرياً من واجهة المستخدم.
تحسين سير العمل وتحديث القواعد
يتطلب العمل المتطور تخصيص أوامر التشغيل إذا كانت تختلف عن الإعدادات الافتراضية (مثل استخدام pnpm بدلاً من npm). علاوة على ذلك، يعد تحديث ملف القواعد بعد كل تصحيح يطلبه المستخدم وسيلة لبناء قاعدة معرفية طويلة الأمد للوكيل.
- يجب ذكر الأدوات الخاصة غير الافتراضية في الملف لضمان استخدامها بدلاً من أدوات النظام القياسية.
- يحتاج ملف القواعد إلى تحديث مستمر بناءً على الدروس المستفادة من أخطاء التنفيذ السابقة.
إدارة المخاطر وهيكلة الملفات المتقدمة
لحماية سلامة المشروع، يجب وضع قواعد صارمة تمنع الأوامر غير القابلة للتراجع دون تأكيد. في المشاريع الكبيرة (Mono repo)، ينبغي توزيع التعليمات على ملفات فرعية لضمان التركيز، مع ترتيب التعليمات في كل ملف حسب الأولوية وعدم تجاوز حد الـ 300 سطر.
- يجب منع تشغيل أوامر مدمرة مثل force pushing دون طلب إذن صريح من المستخدم.
- يفضل استخدام ملفات قواعد ذات نطاق محدد (path scoped) للمشاريع الكبيرة لتقليل تضخم السياق.
설명
The claude.md file decides if Claude Code ships the right implementation. Running init isn't enough for a real claude code setup. We compiled the best claude.md setup patterns from Karpathy and hours of testing, plus claude code tips that stop you fighting your agent on every task. Skip the setup headache get started with Klaus here: https://klausai.com/r/Mv1e2 Community with All Resources 📦: http://ailabspro.io Video Code: V57 We're building The Roundup — a daily newsletter covering the AI stories that actually matter. Join now at: https://www.theroundup.so/ In this Claude Code tutorial we walk through how to create claude.md file the right way, with claude.md best practices pulled from Andrej Karpathy's skills repo and our own hours of running Claude Code from Anthropic on real projects. If you want to know how to structure claude.md so your agent stops guessing and actually ships the right code, this is the full playbook. We cover the karpathy claude.md patterns first: think before coding, simplicity, surgical changes, and goal-driven execution. Then we go into the parts that come from shipping day after day, including tool overrides, scoped rule files, project description placement, Git commit safety, and the order your instructions need to follow inside the claude.md file. We also cover scoped claude.md for monorepos, why verification matters before reporting a task complete, and the 300 line limit that keeps agent performance high. Want to sponsor a video? Learn more here: https://ailabs.services/ This is the best claude.md setup we have landed on after building with Claude AI and testing every pattern that has come out of the community. If you want to configure claude.md file to start a project the right way, or you are doing any vibe coding with Claude Code, this claude code claude.md guide will save you hours of course-correction. It pairs cleanly with the workflows we have covered around Claude Skills and the wider Anthropic agent stack. 0:00 Intro 0:46 Think Before Coding 1:57 Simplicity First 3:03 Surgical Changes 4:25 Goal Driven Execution 5:48 Tool Overrides 7:02 Update claude.md as You Build 7:43 Sponsor 8:35 Git Commit Safety 9:17 Path Scoped Rule Files 10:13 Scoped claude.md for Monorepos 11:18 Project Description First 11:45 Verify, Don't Just Check 12:22 Order by Priority Hashtags: #claudecode #claude #ai #claudeai #claudecodetutorial #claudeskills #vibecoding #anthropic #claudemd