ثبّتنا الأدوات، وعرفنا كيف نختار بينها. ما يصبح مؤثّراً بعد ذلك هو «كيف تطلب من الذكاء الاصطناعي». فبـ Claude Code نفسه، تتضاعف جودة الناتج أضعافاً بحسب أسلوب التعليمة الواحدة. في هذا الفصل نكتسب فنّ «الطلب بإتقان» حول أسلوبين كبيرين مع الذكاء الاصطناعي ― البرمجة بالإحساس التي تصنع فيها بخفّة وأنت تحاور، والتطوير المدفوع بالمواصفات الذي تُثبّت فيه المواصفات أولاً لتصنع بدقة. هنا تكمن أهمّ مفاتيح البرمجة بالذكاء الاصطناعي.
الشعار: «الاستكشاف الصغير vibe، والدقّة الكبيرة spec»
جودة التعليمات تحسم النتيجة
أول ما تتعثّر عنده في البرمجة بالذكاء الاصطناعي ليس «تشغيل الأداة» عادةً، بل «أسلوب الطلب». فالذكاء الاصطناعي لا يقرأ ما في رأسك. إن سلّمته عبارةً غامضة، خمّن الناقص وملأه من عنده فأعادك بشيفرة تبدو صالحة لكنها منحرفة عن قصدك. وبالعكس، إن عبّرت بدقّة عمّا تريد صنعه ولماذا وكيف، أتقنه بدقّة مذهلة. «جودة التعليمة» تصير مباشرةً «جودة النتيجة» ― هذه أهمّ رسالة يتخلّلها هذا الفصل. ولأسلوب الطلب هذا نمطان كبيران.
البرمجة بالإحساس ― تصنع وأنت تحاور
البرمجة بالإحساس (vibe coding) هي أسلوب تصنع فيه بالمحاولة والخطأ وأنت تحاور الذكاء الاصطناعي، دون أن تُثبّت التصميم الدقيق مسبقاً. تعبّر بشكل خشن «أريد شيئاً على هذا النحو»، وتنظر إلى ما ينتج فتضيف «قليلاً هكذا» و«صحّح هنا»، متراكماً الحوار، وتبلور الشكل تاركاً الأمر للإحساس (vibe). سحرها الأكبر أنها يسيرة واستكشافية، وتُخرج الفكرة إلى شكل دفعةً واحدة.
🎨 تصوّرها: إحساس تبحث فيه عن الشكل وأنت تعجن الطين، دون رسم مخطّط. لأنك «تفكّر وأنت تصنع»، فحتى الفكرة التي لم تتبلور بعد في رأسك يمكنك أن تحرّك يدك لتتحقّق منها.
لنضع جنباً إلى جنب المواضع المناسبة والمزالق التي يجدر الانتباه إليها.
- الأشياء الصغيرة: سكربت لمرة واحدة، أداة بسيطة، تطبيق بشاشة واحدة.
- التجربة والنموذج الأوّلي: حين تريد الحكم برؤية الشكل. تجربة على أساس أنها ستُرمى.
- التعلّم والتمرين: حين تلمس تقنية جديدة وتستكشف إحساسها.
- التصميم العام يتذبذب: يتأرجح المنهج مع كل محادثة، فيسهل فقدان الاتّساق.
- ينهار مع كبر الحجم: كلّما كثرت الملفات، عجز الذكاء الاصطناعي والإنسان عن الإحاطة بالكل.
- يصبح المحتوى صندوقاً أسود: تتراكم شيفرة تعمل لكن لا تستطيع شرح سبب عملها.
💡 باختصار: البرمجة بالإحساس الأقوى لـ«التجربة السريعة»، لكنها لا تناسب «التنمية الكبيرة والصيانة الطويلة». اجعل الكلمات الثلاث صغير، قابل للرمي، استكشاف مقياساً، فيقلّ فشلك.
التطوير المدفوع بالمواصفات ― تقرّر أولاً فتصنع بدقة
التطوير المدفوع بالمواصفات (spec-driven development) أسلوب مناقض للبرمجة بالإحساس. قبل البدء بكتابة الشيفرة، تجمع «ماذا تصنع وكيف» في وثيقة مواصفات، ثم تسلّمها للذكاء الاصطناعي لينفّذها بدقّة. لا تحاور ارتجالاً، بل تُشغّل الذكاء الاصطناعي وفق مخطّط متّفق عليه.
الطريقة بسيطة. أولاً تصنع وثيقة المواصفات بالتشاور مع الذكاء الاصطناعي، ثم تضعها في المشروع (كملف في الغالب)، وتمضي في التنفيذ وأنت تُحيله إلى تلك المواصفات.
تصوغ الغرض والميزات والمدخلات والمخرجات والقيود نصاً. الأسرع أن تجعل الذكاء الاصطناعي يكتب مسوّدةً ثم تصحّحها.
قبل التنفيذ، تقرأ المواصفات بنفسك وتُزيل الثغرات والتناقضات. هنا مفترق الجودة.
تُعطي تعليمة «نفّذ وفق هذه المواصفات». وإن انحرف، عدت إلى المواصفات وصحّحت.
- الأشياء الأكبر قليلاً: تطوير يمتدّ لعدة ميزات وعدة ملفات.
- حين تهمّ الجودة: ما يضرّك إن انكسر لاحقاً، وما يُصان طويلاً.
- ما يقرؤه فريق أو غيرك: تصبح المواصفات مرجعاً مشتركاً.
- لا تستهدف الكمال من البداية، بل ابدأ المواصفات صغيرة ونمّها.
- المواصفات تقرؤها أنت بالضرورة. فالمواصفات المتروكة للذكاء الاصطناعي تمتلئ ثغرات.
- إن انحرف التنفيذ، فلا تصحّح ارتجالاً بالحوار، بل صحّح المواصفات ثم أعِد.
📐 لماذا ينجح: الذكاء الاصطناعي لا يرى إلا «هذه المحادثة الحالية». فبوضع وثيقة المواصفات ― معياراً يمكن العودة إليه دائماً ― مسبقاً، لا يتذبذب المنهج مهما طال الحوار، وتقلّ الثغرات والتراجعات في التنفيذ. جوهر الأمر أنك «تسلّم الذكاء الاصطناعي مخطّطاً ثم تجعله يصنع» فقط، لكن أثره هائل.
كيف تختار ― استكشاف صغير أم دقّة كبيرة
ليست المسألة أيّهما أفضل. الصواب أن تختار بحسب «حجم» و«غرض» ما تصنعه. لنقابل بين الأسلوبين على محاور.
| الحجم | صغير |
| الغرض | تجربة · استكشاف · تعلّم |
| طريقة العمل | محاولة وخطأ بالحوار |
| السرعة | سريعة جداً |
| نقطة الضعف | تنهار حين تكبر |
| الحجم | متوسط ~ كبير |
| الغرض | جودة · صيانة · إنتاج |
| طريقة العمل | مواصفات ← تنفيذ |
| السرعة | الانطلاق بطيء |
| نقطة الضعف | ثقيل على الأشياء الصغيرة |
✅ في الواقع «تتنقّل» بينهما. لا حاجة لتثبيت أحد الخيارين. جرّب أولاً نموذجاً أوّلياً سريعاً بالبرمجة بالإحساس، فإن أحسست بجدوى الفكرة فأنزلها إلى مواصفات وانتقل إلى التنفيذ الفعلي ― هذا التدفّق الأقوى في العمل الحقيقي. الاستكشاف الصغير vibe، ومرحلة التنمية spec. بدّل الأسلوب داخل مشروع واحد.
خمس حيل للتعليمات الجيدة
في كلا الأسلوبين، إن كانت التعليمة (البرومبت) التي تسلّمها للذكاء الاصطناعي جيدة، ارتفعت النتيجة. لنمسك بخمس حيل أساسية تستخدمها من اليوم، عبر البطاقات. للتعمّق: الدليل العملي لهندسة البرومبت.
ليس «اجعله لطيفاً» بل حدّد ماذا تريد وكيف. كلّما بيّنت الأرقام والشروط والهدف، ارتفعت الدقّة.
بلّغه اللغة وإطار العمل والملفات ذات الصلة والقيود. كلّما عرف الخلفية، صار أدقّ.
لا تطلب هذا وذاك دفعةً واحدة. إن طلبت مقسّماً صغيراً واحداً تلو الآخر، سهُلت المراجعة والتصحيح.
أرِه الشكل المطلوب (اسم الدالة، القيمة المُعادة، مثال المخرجات، التنسيق) مسبقاً. مشاركة الهدف تقلّل الانحراف.
لا تستهدف الكمال من الطلقة الأولى. الأسرع أن تنظر إلى المخرجات وتراكم تصحيحاً محدّداً «هنا هكذا».
لأن الكلام وحده يصعب الإمساك به، لنضع الطلب نفسه جنباً إلى جنب في صورة «تعليمة سيئة» و«تعليمة جيدة».
«اصنع ميزة تسجيل دخول.»
اللغة، ومكان الحفظ، وسلوك النجاح والفشل ― كلها مجهولة. يملأ الذكاء الاصطناعي كل شيء بالتخمين، فيعيدك بشيفرة تخالف تصوّرك. سبب للتراجع.
«أضِف إلى مشروع Laravel ميزة تسجيل دخول بالبريد وكلمة المرور. استخدم جدول users القائم. عند نجاح المصادقة انتقل إلى /dashboard، وعند الفشل اعرض رسالة خطأ. اجعل كلمة المرور متوافقة مع طريقة التجزئة القائمة. اقترح أولاً routes وController فقط، والتنفيذ بعد مراجعتي.»
تبيّن الغرض والسياق وشرط النجاح ونطاق المخرجات وطريقة العمل. الحيل الخمس كلها فيها.
🧩 خطوة إلى الأمام: فكرة تصميم «ما تبلّغه للذكاء الاصطناعي» بل وكيف تُوصِل أيّ معلومة عبر المشروع كله تُسمّى هندسة السياق، وفكرة تهيئة بيئة عمل الذكاء الاصطناعي بأكملها (الأدوات والأذونات وملفات التعليمات) تُسمّى هندسة التسخير (harness). حين تشتاق للتطوّر، أطِلّ عليهما.
حين يتجاهل الذكاء الاصطناعي القواعد
في Claude Code آلية تجمع تعليمات كل مشروع في ملف مثل CLAUDE.md ليلتزم بها الذكاء الاصطناعي دائماً. غير أنك تواجه عند الاستخدام الفعلي مواقف «يتجاهل فيها الذكاء الاصطناعي قواعد كتبتها». والأسباب عدّة.
إن كانت القواعد ضخمة انطمر المهمّ منها. قلّل العدد وبيّن الأولوية.
إن اتّسع مجال التأويل لم تُلتزم. اجعلها محدّدة وقابلة للتحقق.
إن طال التبادل بهتت التعليمات الأولى. ذكّره بها في المواضع المهمّة.
💡 جوهر العلاج: اكتب القواعد «باختصار، بتحديد، مع أولوية». والقواعد المهمّة، ذكّر بها مرةً أخرى في الحوار عند الحاجة. أما التمييز التفصيلي للأسباب وطرق الإصلاح الملموسة، فنشرحها في لماذا يتجاهل الذكاء الاصطناعي قواعد CLAUDE.md وكيف تعالج ذلك.
- جودة التعليمة هي جودة النتيجة. الذكاء الاصطناعي يملأ الناقص بالتخمين، فكلّما طلبت بدقّة عاد بدقّة.
- البرمجة بالإحساس = محاولة وخطأ وأنت تحاور. قويّة في الصغير والقابل للرمي والاستكشاف. تنهار حين تكبر.
- التطوير المدفوع بالمواصفات = تقرّر المواصفات أولاً فتنفّذ بدقّة. قويّ في المتوسط ~ الكبير وحين تهمّ الجودة.
- الاختيار: «الاستكشاف الصغير vibe، والدقّة الكبيرة spec». وفي الواقع تتنقّل بينهما.
- حيل التعليمة الجيدة خمس: التحديد، السياق، مهمة واحدة، مثال المخرجات، التكرار.
- يتجاهل الذكاء الاصطناعي القواعد لأنها طويلة أو غامضة أو المحادثة طالت. اكتبها باختصار وتحديد، وذكّر بها.
حين تُتقن أسلوب الطلب، تستقرّ البرمجة بالذكاء الاصطناعي دفعةً واحدة. ومع ذلك، إن حرّكت يدك فعلاً، فلا بدّ أن تواجه أخطاءً وطرقاً مسدودة. في الفصل الخامس «تجاوز العقبات»، لنمسك بشكل منهجي بأسباب الأخطاء الشائعة وطرق الخروج منها.