ثلاث كلمات توقف كلود عن تعقيد الحل
كلود بطبيعته يبني أكثر مما طلبت. جملة واحدة تغيّر النتيجة كلياً.
تعطي كلود مهمة صغيرة وترجع تلاقي ملفات جديدة، ودوال ما طلبتها أصلاً، وكود أطول بثلاث مرات. هذا مو خلل تقني. كلود مدرّب يكون مفيداً بشكل مبالغ فيه، ويفترض دايمًا إنك تبي الحل الأشمل. بصراحة، في معظم الأوقات اللي تبيه هو الأقل.
🧩 إيش المشكلة بالضبط
حين يقرأ كلود طلبك، ما يحل فقط اللي كتبته. يفكّر في السياق، يتساءل "إيش ممكن يحتاجه هذا الشخص بعد كذا؟" ثم يضيف. الميزة الجديدة اللي ما ذكرتها، الملف المساعد اللي "راح يكون مفيدًا"، إعادة هيكلة الكود لأن "هذا أنظف"، التعليقات الإضافية اللي ما تبيها.
يعني لو قلت "أضف validation للإيميل"، كلود يضيف الـ validation، ويعيد تنظيم الدوال المجاورة، ويضيف error messages بأسلوب مختلف، وربما ينشئ ملف utilities جديد. طلبت شيء واحد. وصلك خمسة. هذا مو فشل، هذا كلود يسوي بالضبط اللي تدرّب عليه.
⚙️ كيف توقفه بثلاث كلمات
كلود يعامل كلمة "مفيد" بمعنى "كامل". هذا ممتاز حين تطلب شرحاً أو تحليل. بس حين تشتغل على كود، الأكمل مو دايمًا الأفضل. في أغلب الأحيان هو الأصعب في المراجعة، والأصعب في الـ merge.
الحل بثلاث كلمات بالإنجليزي: minimal changes only
هذه الكلمات تضيفها في بداية أي طلب تقني. حين يقرأها كلود، يفهم إن مهمته تنحصر في اللي طلبته بالضبط فقط. الطريقة:
1️⃣ حدّد طلبك بدقة كما اعتدت، بدون تغيير
2️⃣ أضف "minimal changes only:" مباشرة قبل طلبك في نفس الرسالة
3️⃣ أرسل وراجع الـ diff، ستشوف الفرق مباشرة
الفرق العملي واضح. بدون الجملة: "أضف validation للإيميل في نموذج التسجيل" يرجع لك كود أعيد تنظيمه مع إضافات. معها: "minimal changes only: أضف validation للإيميل في نموذج التسجيل" يرجع لك تغيير في ملف واحد، في السطور المحددة، لا غير.
🌍 وين تحتاج هذه الجملة أكثر
🐛 حين تُصلح bug محددة وما تبي كلود "ينظّف" الكود المجاور معها
➕ حين تضيف ميزة صغيرة وما تبي ملفات جديدة تظهر فجأة
🔍 حين تريد تراجع الـ diff بسرعة وبدون ضوضاء
⚠️ حين تشتغل على codebase حساسة وأي تغيير خارج النطاق يسبب مشاكل
🛠️ الأدوات اللي تستخدمها فعلاً
هذه الجملة تشتغل في كل مكان تستخدم فيه كلود. هنا كيف تثبّتها بشكل دائم في أكثر الأماكن شيوعاً:
🔧 Claude.ai Projects
المشاريع في claude.ai تتيح لك كتابة system prompt ثابت يُطبّق على كل محادثة داخل المشروع. يعني ما تحتاج تكرر الجملة في كل مرة.
كيف تبدأ:
1️⃣ افتح claude.ai واذهب إلى Projects أو أنشئ مشروعاً جديداً
2️⃣ اضغط على "Project instructions" أو "Edit project details"
3️⃣ أضف هذه الجملة في أي مكان في التعليمات: "Make minimal changes only. Do not add files, features, or reorganize code beyond what is explicitly requested."
🔧 Claude API
إذا تستخدم كلود عن طريق الـ API مباشرة، تتحكم في الـ system prompt بشكل كامل.
كيف تبدأ:
1️⃣ افتح إعدادات الـ API call عندك
2️⃣ في حقل "system"، أضف: "Make minimal changes only. Stick strictly to what is requested and nothing beyond."
3️⃣ هذا يطبّق على كل رسالة في الجلسة تلقائياً دون تكرار
💡 جرّب بنفسك: خطوة بخطوة
الهدف: تشوف الفرق بنفسك بين طلب عادي وطلب بالجملة السحرية.
1️⃣ افتح claude.ai وابدأ محادثة جديدة نظيفة
2️⃣ اكتب أي طلب تقني بسيط، مثلاً: "في هذه الدالة، حوّل الـ string إلى lowercase قبل المقارنة" وأضف الكود المرتبط
3️⃣ لاحظ الرد: كم سطر تغيّر؟ هل أضاف كلود شيئاً ما طلبته؟
4️⃣ افتح محادثة جديدة تانية وكرّر نفس الطلب بالضبط، بس أضف في البداية: "minimal changes only:" ثم اكتب نفس الطلب
5️⃣ قارن النتيجتين. في الغالب ستلاحظ فرقاً واضحاً في حجم الـ diff وما تغيّر فعلاً
النتيجة المتوقعة: النسخة الثانية تعطيك بالضبط اللي طلبته، بدون إضافات، وبدون ضوضاء.
وش تسوي بعد ذا
✅ في أقرب طلب تقني ترسله لكلود، ابدأه بـ "minimal changes only:" وشوف الفرق بنفسك
✅ إذا تستخدم Claude.ai Projects أو الـ API، أضف التعليمة في الـ system prompt مرة وخلاص
✅ اسأل نفسك قبل كل طلب: أبي الأشمل أو الأدق؟ الجواب يغيّر كيف تكتب رسالتك
كلود ما يعرف وين يوقف إلا لو قلت له وين الحد.
———— English ————
Three Words That Stop Claude Over-Building
A small instruction that keeps Claude focused and gives you cleaner results fast.
You give Claude a small task and come back to find new files, functions you never asked for, and code three times longer than it needed to be. This is not a bug. Claude is trained to be maximally helpful, which means it assumes you want the most complete version of whatever you asked. Most of the time, you want less.
What it actually is
When Claude reads a request, it does not just solve what you typed. It thinks about context, anticipates what you might need next, and adds. The new utility function that "makes sense here," the refactored adjacent code because it was "cleaner that way," the extra error handling, the brand new helpers file. You asked for one thing. You got five.
Ask Claude to "add email validation to the signup form" and it will validate the email, reorganize neighboring functions, add error messages in a new style, and possibly generate a utilities file you never requested. That is not failure. That is Claude doing exactly what it was trained to do. The problem is that it does this when you did not ask.
⚙️ How it works and how to stop it
Claude treats "helpful" as equivalent to "complete." This serves you well when you want explanations or analysis. When you are working with code, complete is not always better. It is often just harder to review, harder to understand, and harder to merge cleanly.
The fix is three words: minimal changes only
Add this phrase at the start of any technical request. When Claude reads it, it constrains itself to exactly what you specified with nothing beyond, no unsolicited improvements, no surprise additions.
Here is how to apply it:
1️⃣ Write your request exactly as you normally would, no rewording needed
2️⃣ Prefix the message with "minimal changes only:" directly before your ask
3️⃣ Send it and check the diff — you will see the difference immediately
The contrast is concrete. Without the phrase: "add email validation to the signup form" returns reorganized code with extras. With it: "minimal changes only: add email validation to the signup form" returns a targeted change in one file, on the relevant lines, nothing else touched.
🌍 Where you need this most
🐛 When fixing a specific bug and you do not want Claude cleaning up surrounding code in the same pass
➕ When adding a small feature and you cannot afford new files appearing without a review
🔍 When you need to read and understand the diff quickly after the change
⚠️ When working on a sensitive codebase where any change outside the requested scope creates real downstream problems
🛠️ Tools you actually use
This phrase works everywhere Claude runs. Here is how to make it permanent across the most common setups so you never have to type it again:
🔧 Claude.ai Projects
Claude.ai Projects let you write a persistent system prompt that applies to every conversation inside the project automatically.
How to set it up:
1️⃣ Go to claude.ai and open an existing Project or create a new one
2️⃣ Click "Project instructions" or "Edit project details" depending on your interface version
3️⃣ Add this line anywhere in the instructions: "Make minimal changes only. Do not add features, files, or reorganize code beyond what is explicitly requested."
🔧 Claude API
If you call Claude via the API directly, you control the system prompt completely and can inject the constraint once at the session level.
How to set it up:
1️⃣ Open your API call configuration wherever you manage it
2️⃣ In the "system" field, add: "Make minimal changes only. Stick strictly to what is requested and nothing beyond."
3️⃣ The constraint applies to every message in that session without repeating it each time
💡 Try it yourself: step by step
Run this experiment with any small code change you have been meaning to make:
1️⃣ Open claude.ai and start a completely fresh conversation
2️⃣ Type a straightforward technical request and include the relevant code, for example: "In this function, convert the string to lowercase before the comparison"
3️⃣ Note what comes back: how many lines changed, what else did Claude touch that you did not mention
4️⃣ Open a second fresh conversation and type the exact same request, but prefix it with "minimal changes only:" before your instruction
5️⃣ Compare the two outputs — look specifically at what changed beyond the one thing you asked for
What you will see: the second response is narrower, cleaner, and covers exactly what you asked. The diff is readable in thirty seconds instead of five minutes.
What to do next
✅ Use "minimal changes only:" as the opening of your next precise technical request and see the difference firsthand
✅ If you use Claude.ai Projects or the API, add the constraint to your system prompt once so it applies everywhere without repeating it
✅ Before each Claude request, ask yourself: do I want thorough or targeted? Let your honest answer shape how you write the prompt
Claude does not know where to stop unless you tell it where the boundary is.