اكتب ملف قواعد عشان الـ AI بتاعك يبطّل يغلط نفس الغلطة
الخلاصةاعمل ملف اسمه CLAUDE.md جنب الكود بتاعك. حط فيه تفضيلاتك، معايير الكود بتاعتك، والغلطات اللي اتعلمت منها — نص عادي، من غير فورمات تتعلمه. Claude بيقراه تلقائي في أول كل session ويتبعه من غير ما حد يقوله. دي الحيلة كلها.
…
ده بيشتغل مع Claude Code بس؟
الملف نفسه فكرة عامة — مجرد ملف Markdown فيه تعليمات. Claude Code وتطبيق Claude على الكمبيوتر الاتنين بيقروا ملف اسمه CLAUDE.md تلقائي. أدوات AI تانية بتستخدم اسم مختلف (بعضها بيسميه system prompt أو project instructions) بس الفكرة واحدة: اكتب القاعدة مرة، بطّل تكررها.
يكون طوله قد إيه؟
أقصر ما يمكن. ابدأ بـ 5 إلى 10 قواعد. ملف قواعد الناس بتتبعه فعلاً أحسن من مستند سياسات 200 سطر Claude بيقراه نُص نُص. ضيف سطر بس لما تكرر نفس الملاحظة مرتين.
ملف كبير مش هيبطّئ كل session؟
بيتحمّل مرة واحدة في الأول وبياخد شوية context بسيط — ده الاتفاق. خليه مركّز ومحدد بدل ما تحط فيه كل رأي عندك، وهيفضل رخيص مقارنة باللي بيوفّره لك من تصحيحات متكررة.
الفرق بينه وبين الـ memory vault بتاع الحلقة 3؟
الـ vault (حلقة 1 لـ 3) هو اللي Claude *بيفتكره* — حقائق وقرارات ودروس من sessions قديمة. ملف القواعد هو اللي Claude *بيعمله دايماً* — تعليمات ثابتة بيتبعها من غير ما تطلب. الـ memory هو المدخل، والقواعد هي السلوك. أحسن إعداد فيه الاتنين، وغالباً ملف القواعد نفسه بيوجّه Claude إنه يراجع نظام الـ memory بتاعك.
قلت لل AI بتاعك نفس الكلام خمس مرات الأسبوع ده. «شغّل التستات قبل ما تقول إنك خلصت.» «متستخدمش any.» «دايماً راجع الـ env vars قبل ما تعمل deploy.» كل session، بتكتبها تاني — عشان الـ AI مالوش ذاكرة للتصحيح اللي عملته إمبارح. ملف القواعد بيحل المشكلة دي مرة واحدة وخلاص: اكتب التعليمة مرة، في ملف نص عادي، و Claude بيقراها تلقائي في أول كل session من دلوقتي. من غير ما تشرح تاني، من غير ما تراقبه.
إيه هو ملف القواعد فعلاً؟
مجرد ملف Markdown — نص عادي، من غير فورمات خاص — اسمه CLAUDE.md، موجود في فولدر مشروعك (أو ملف عام لكل المشاريع). Claude Code وتطبيق Claude على الكمبيوتر بيدوّروا عليه تلقائي ويحمّلوه قبل ما يعملوا أي حاجة. مش محتاج ترفقه، مش محتاج تلصقه، مش محتاج تفكّر Claude إنه موجود. هو بس... موجود، كل مرة، بيشكّل سلوك Claude.
فكّر فيه زي الفرق بين إنك تدرّب موظف جديد من الأول كل صباح، وبين إنك تدّيله ورقة onboarding مرة واحدة وخلاص. الورقة دي هي ملف القواعد.
تحط فيه إيه فعلاً؟
أربع فئات بتغطي كل حاجة تقريباً:
مين انت وتفضيلاتك — الـ stack بتاعك، مستوى خبرتك، طول الإجابات اللي عايزها، الأسلوب.
قواعد الشغل — Claude يشتغل إزاي: إمتى يسأل قبل ما يتصرف، إمتى يشغّل التستات، إزاي يتعامل مع الـ commits.
الغلطات والدروس — دي أهم حاجة. كل مرة حاجة تبوظ أو Claude يعمل حاجة غلط، دي قاعدة جاهزة تتكتب. وهنا عادة الـ memory من الحلقة 3 بتدفع فايدتها مباشرة: درس حفظته مرة بيبقى قاعدة Claude بيلتزم بيها تلقائي، بدل ملاحظة ممكن ماترجعش تقراها تاني.
المحدد أحسن من العام — دايماً
دي الحاجة الوحيدة اللي بتفرّق بين ملف قواعد بيشتغل وواحد بيتجاهَل. «اكتب كود كويس» مالهاش معنى بالنسبة للـ AI — مافيش طريقة يتأكد بيها من نفسه. «شغّل التستات قبل ما تقول إنك خلصت» قاعدة Claude يقدر يتبعها فعلاً وانت تقدر تتأكد منها.
القواعد العامة بتتقرا بسرعة وبتتنسى. القواعد المحددة والقابلة للتأكد بتتبع، عشان كل واحدة فيها فعل واضح مربوط بيها.
أهو مثال صغير وعام — مش حقيقي، بس ده الشكل:
# My rules## Who I amI'm a solo developer building a Next.js + Postgres app.Keep answers short — I know the basics, skip the intro.## Coding standards- TypeScript everywhere, no `any`.- Match the existing file's style before introducing a new pattern.## Workflow- Run the tests before saying a task is done.- Never commit directly to `main` — always a branch, always ask first.## Gotchas (lessons learned)- Always double-check env vars before deploying — I've shipped with a missing key twice.- Never delete a database column in the same change that stops using it. Wait one release, then remove it.
ثمن سطور، كل واحدة فيها ممكن تتأكد منها. دي الفكرة كلها — انسخ الشكل ده، واملاه بتفضيلاتك انت وغلطاتك انت.
قواعد عامة ولا قواعد لكل مشروع؟
هيبقى عندك طبقتين، وتستحق تعرف الفرق من أول يوم:
قواعد عامة (ملف واحد، بيتطبق على كل مشروع) — هويتك، معاييرك العامة، عادات الشغل اللي عايزها في كل حتة. تظبّطها مرة وتنساها.
قواعد لكل مشروع (ملف CLAUDE.md جوه الـ repo بتاع المشروع ده بالذات) — الـ stack بتاع المشروع ده، خصوصياته، قرارات خاصة بيه. Claude Code بيقرا الاتنين ويحط ملف المشروع فوق الملف العام.
ابدأ بالعام. ضيف ملف لكل مشروع أول ما مشروع معين يحتاج قاعدة مش لازم تتطبق في كل حتة تانية — تفصيلة خاصة بـ framework معين، أو اصطلاح تسمية الـ codebase ده بس بيستخدمه.
ليه يستاهل خمس دقايق
كل تصحيح بتديه للـ AI من غير ما تكتبه، هتديه تاني الأسبوع الجاي. ملف القواعد بيحوّل التصحيح اللي عملته مرة لمعيار دايم — Claude بيتبعه وخلاص، بهدوء، في أي مهمة جاية. مراقبة أقل، غلطات متكررة أقل، وسلوك ثابت سواء كانت أول session في يومك أو الخمسين. لما تجمع بين نظام memory بيحفظ الدروس (حلقة 3) وملف قواعد بيفرضها، الـ AI بتاعك بيبطّل يكرر نفس الغلطة — عشان عمرك ما هتحتاج تقوله مرتين.
إزاي ده متوصّل بباقي الإعداد
ملف القواعد هو طبقة التحكّم — هو المكان اللي بتشغّل منه كل قطعة تانية:
وجّهه على الـ vault والـ graph عشان كل session تبدأ بقراية الخريطة بدل التخمين.
قوله يحمّل فهرس الـ memory الأول، وده اللي بيحوّل الـ loop ده لحاجة أوتوماتيك بدل عادة.
حدّد الـ skills اللي تتستخدم لكل شغلانة، عشان الـ workflow الصح يشتغل من غير ما تطلبه.
AI FROM MY POV