ها هي أخيراً المرحلة الثالثة «البناء». بالمواصفات التي قرّرتها في الفصل الثاني، والتقنية والأدوات التي اخترتها في الفصل الثالث، تُركّب فعلاً شيئاً يعمل. أكثر من يتعثّر هنا لا يتعثّر في الحقيقة لأنه «لا يستطيع كتابة الشيفرة»، بل لأنه يسعى إلى الاكتمال دفعة واحدة. يرشدك هذا الفصل — بالذكاء الاصطناعي رفيقاً — إلى طريقة بناء تُدير بسرعة «ابنِ الصغير ثم شغّله»، في كلا المسارين: المبتدئ والممارسة.

«طريقة البناء» التي تكتسبها في هذا الفصل

المقصود ليس «الاكتمال دفعة واحدة» بل «تقدّم صغير»

بناء دوّار
تكتسب عادة تكرار «ابنِ ← شغّل ← أصلح» صغيراً وسريعاً.
تنفيذ لكل مسار
🌱 مسار المبتدئ الذي يصلح بالحوار، و🔧 مسار الممارسة الذي يسلّم المواصفات، طريقة كلٍّ منهما.
تضمين الذكاء الاصطناعي
تصبح قادراً على اختيار كيفية تحميل الذكاء الاصطناعي في تطبيقك (API، نماذج متعددة، RAG).

النهج الأساسي للتنفيذ ― أدِر الصغير

أهمّ نهج في التنفيذ واحد لا غير: أن تكرّر بسرعة «ابنِ الصغير وشغّله، ثم أصلح». لا تحاول صنع الصورة المكتملة في رأسك دفعة واحدة، بل ابنِ أولاً أصغر «كتلة تعمل»، ثم نمِّها شيئاً فشيئاً.

لماذا ينجع هذا؟ لأن البرنامج لا تعرف ما الخطأ فيه إلا حين تشغّله. إن كتبت 100 سطر ثم شغّلتها مرة واحدة، حِرت أين السبب فوقفت عاجزاً. أما إن كتبت 10 أسطر وشغّلتها، فالخطأ لن يكون إلا في تلك العشرة. والأمر نفسه تماماً حين تجعل الذكاء الاصطناعي يكتب: اطلب الصغير، وتحقّق فوراً، فتمضي في النهاية أسرع وأوثق.

😓 إخفاق يقع فيه الكثيرون

ترمي للذكاء الاصطناعي «ابنِ كل الوظائف دفعة واحدة». تخرج شيفرة ضخمة، لكن تشغيلها مليء بالأخطاء. لا تعرف أين السبب، وتفقد همّة الإصلاح.

🚀 الطريقة الناجحة

تطلب وظيفة واحدة كل مرة بـ«أولاً شاشة عرض القائمة فقط». إن عملت انتقلت للتالي، وهكذا تراكم. تمضي قدماً وأنت تُبقي دائماً حالة «تعمل».

⚠️ شيفرة الذكاء الاصطناعي تُخطئ أيضاً ― لذا شغّلها بنفسك دائماً. الشيفرة التي يكتبها الذكاء الاصطناعي، وإن بدت وجيهة، كثيراً ما تكون خاطئة عند التشغيل أو تتصرف على خلاف المقصود. «ما دام الذكاء الاصطناعي كتبها فهي صحيحة» ممنوع. شغّل الشيفرة الخارجة بيدك دائماً، وتحقّق منها بعينك. هذه أول قاعدة تكتسبها في التطوير الفردي. إن مضيت دون تشغيل، تراكمت الأخطاء حتى تعجز عن السيطرة.

خطوات دورة «ابنِ، شغّل، أصلح»

هذا «الإدارة الصغيرة» في أربع خطوات ملموسة هو الرسم أدناه. تُدير وظيفة واحدة عبر هذه الدورة دوراناً متكرراً. الدورة الواحدة من دقائق إلى عشرات الدقائق. كلما أدرتها أسرع، مهرت أكثر.

STEP 1
اطلب الصغير

اطلب من الذكاء الاصطناعي بدقة «الآن هذه الوظيفة الواحدة فقط». كلما ضيّقت النطاق ارتفعت الدقة.

STEP 2
شغّل فوراً

فور خروجها نفّذها. تحقّق من النتيجة بعينك في المتصفح أو الطرفية.

STEP 3
أصلح ونسّق

إن ظهر خطأ أو شيء مزعج، عدّله بالحوار «أصلِح هذا هكذا». كرّر حتى يعمل.

STEP 4
احفظ وانتقل

إن عملت احفظها كمحطة (commit). أبقِ الحالة الجيدة، وانتقل للوظيفة التالية.

💡 لا تستهِن بالخطوة الرابعة «الحفظ». إن حفظت (commit في Git) كلما عملت وظيفة، أمكنك العودة إلى آخر حالة تعمل إن كسّر التغيير التالي شيئاً. إنه حبل نجاة يمنع مأساة «كان يعمل بالأمس». الطريقة الملموسة للحفظ نتناولها بالتفصيل في الفصل الخامس التالي.

أسلوب التنفيذ في مسار المبتدئ ومسار الممارسة

«الإدارة الصغيرة» نهج مشترك، لكن الطريقة الملموسة لإدارتها تتغير بحسب المسار. تحقّق من طريقة السير بحسب مسارك الذي اخترته في الفصل الأول. وبالطبع، لا مانع من المزج أو التبديل في منتصف الطريق.

🌱 مسار المبتدئ ― تُجسّده بالحوار
لا حاجة لقراءة الشيفرة

بـالبرمجة بالإحساس، تُركّب التطبيق وأنت تحاور الذكاء الاصطناعي. «اصنع شاشة قائمة» ← «اجعل لون الزرّ أزرق» ← «اجعله يحفظ عند الضغط»، تطلب بالكلمات، وترى الشاشة، ثم تطلب من جديد. هذا التكرار هو نفسه «دورة الإدارة الصغيرة».

السرّ: اطلب شيئاً واحداً كل مرة. وإن لم ينجح، يكفي أن تقول «تراجَع عن التغيير السابق».

🔧 مسار الممارسة ― تسلّم المواصفات وتُوكِل
تُؤتمِت بمحرر ذكاء اصطناعي

تسلّم وثيقة المواصفات كاملة لـ Claude Code وغيره، وتوكِل إليه تنفيذاً متكاملاً. النقطة أن تضبط الجهد (effort) بحسب حجم العمل، وتُنوّع أوضاع الصلاحيات كي لا يُفرط في تعديل الملفات من تلقائه، لتؤتمِت بأمان.

السرّ: وكّل بالكبير، لكن تحقّق بالصغير. وإن تعثّرت فابحث عن العلاج في دليل الأخطاء.

في كلا المسارين، ما لا يجوز نسيانه هو النهج الأساسي: «شغّل ما يخرج بنفسك وتحقّق منه». سواء بنيته بالحوار أو أوكلته للتنفيذ التلقائي، التحقّق مهمة الإنسان. ألا تختصر هذه الخطوة اليسيرة هو مفترق الوصول إلى الاكتمال من عدمه.

إن كنت ستُضمّن ميزة ذكاء اصطناعي

إن كان ما تبنيه «تطبيقاً يستخدم الذكاء الاصطناعي» — مثل تلخيص نصّ، أو الإجابة عن سؤال، أو تصنيف صورة — فستحتاج آلية لاستدعاء الذكاء الاصطناعي من داخل التطبيق. يصير الأمر هنا تخصصياً قليلاً، لكن الخيارات تنتظم في ثلاثة كبيرة. يكفي أن تختار ما يحتاجه تطبيقك فقط.

① استدعاء الذكاء الاصطناعي
ابدأ بهذا

إن كنت ستستخدم نموذجاً واحداً من التطبيق، فالأساس استدعاء واجهة برمجة الذكاء الاصطناعي (API). تصوّرها نافذة «ترسل نصاً، فترجع إجابة الذكاء الاصطناعي».

② التعامل مع نماذج متعددة
إن أردت التبديل والمقارنة

إن أردت استخدام عدة نماذج بحسب الموقف، وحّد طريقة الكتابة بـVercel AI SDK. وللإدارة المركزية في التشغيل، بوابة النماذج اللغوية (LLM Gateway) مفيدة.

③ الإجابة من بياناتك
إن أردت تزويده بمعرفة خاصة

إن أردت أن يجيب استناداً إلى مستنداتك أو وثائقك، فـRAG. آلية تُزوّد الذكاء الاصطناعي بـ«وثائق خاصة بك» ليجيب منها، فتُبرز تميّزك.

🧭 إن ترددت فـ① يكفي. في أول MVP، يكفي في الغالب استدعاء واجهة ذكاء اصطناعي واحدة. أما ② و③ فأضِفهما حين تنشأ الحاجة إلى «مقارنة عدة نماذج» أو «الإجابة من بياناتك». هنا أيضاً، «ابنِ الصغير» هو الصواب.

كيف تتصرف عند التعثّر

أثناء التنفيذ، ستتعثّر حتماً في مكان ما. يظهر خطأ، أو لا يعمل كما توقعت — هذا ليس إخفاقاً بل دليل على أنك تبني. المهم عند التعثّر ألا تُصاب بالذعر، بل تفصل الأمر بالترتيب. مع وجود الذكاء الاصطناعي الآن، تخرج من التعثّر أسرع بكثير من ذي قبل.

1. سلّم نصّ الخطأ للذكاء الاصطناعي كما هو

انسخ النصّ الأحمر كاملاً واسأل «ظهر هذا الخطأ. ما السبب وكيف أُصلحه؟». نصّ الخطأ أكبر دليل. لا تُعدّل باجتهادك، بل الصقه أولاً.

2. افصل الأمر صغيراً

تذكّر «إلى أين كان يعمل». الموضع الواحد الذي غيّرته للتوّ هو السبب غالباً. متى ضيّقت النطاق وُجد السبب حتماً.

3. عُد إلى حالة تعمل

إن تعقّد الأمر، عُد إلى آخر حالة تعمل محفوظة وأعِد الكرّة. كثيراً ما يكون الرجوع أسرع من الملاحقة العميقة.

🔧 إلى من في مسار الممارسة. الأخطاء الشائعة في Claude Code وغيره وعلاجها مجموعة في دليل الأخطاء. الحيرة أمام الخطأ نفسه مضيعة للوقت. اجعل عادتك «عند التعثّر ابحث أولاً، فإن لم ينفع فاسأل الذكاء الاصطناعي».

خلاصة هذا الفصل

لبّ المرحلة الثالثة «البناء» في النهج أكثر من التقنية: «نهج إدارة سريعة لـ‹ابنِ الصغير، شغّله، أصلح›». لا تسعَ إلى الاكتمال دفعة واحدة، بل نمِّ الكتلة التي تعمل شيئاً فشيئاً.

خلاصة هذا الفصل
  • النهج الأساسي هو إدارة سريعة لـ«ابنِ الصغير وشغّله ← أصلح». لا تسعَ إلى الاكتمال دفعة واحدة.
  • شيفرة الذكاء الاصطناعي تُخطئ أيضاً. شغّل ما يخرج بنفسك وتحقّق منه دائماً.
  • 🌱 المبتدئ بـالبرمجة بالإحساس وهو يحاور، و🔧 الممارسة يسلّم المواصفات ويؤتمِت بأمان عبر الجهد وأوضاع الصلاحيات.
  • لتحميل الذكاء الاصطناعي ابدأ بـAPI. النماذج المتعددة بـVercel AI SDK/بوابة LLM، وبياناتك الخاصة بـRAG.
  • عند التعثّر سلّم نصّ الخطأ ← افصل صغيراً ← عُد إلى حالة تعمل. استعِن أيضاً بـدليل الأخطاء.

متى صار لديك شيء يعمل، فالدور تالياً على إخراجه إلى العالم بأمان. يمكنك العودة إلى الفصل الثالث «اختَر التقنية والأدوات» لتراجع التجهيز، لكن متى بدأ التنفيذ يدور، فانتقل إلى الفصل الخامس «اختبر وأخرِج إلى العالم» الذي يُحكم الاختبار والأمان ثم ينشر.