لا تستخدم Claude Code بدون هذا

AAI LABS
Computing/SoftwareSmall Business/StartupsInternet Technology

Transcript

00:00:00الحقيقة هي أن الذكاء الاصطناعي لن يحدث ثورة في عملية بناء البرمجيات، على الأقل ليس بالطريقة التي تظنها.
00:00:05بالتأكيد يجعل كل شيء أسرع، كما يسهل عملية التعافي عندما تسوء الأمور.
00:00:10لكن العمليات التي وُضعت على مدار 60 عاماً من بناء المنتجات لا تزال بنفس الأهمية اليوم، ولكن لأسباب مختلفة،
00:00:16سابقاً تم تطبيقها لضمان وجود طريقة منظمة للبشر لتطوير هذه المنتجات.
00:00:21أما الآن فقد تحول الأمر لتمكين وكلاء الذكاء الاصطناعي من العمل بالطريقة التي يعمل بها البشر.
00:00:25لذا من أجل جعل وكلاء الذكاء الاصطناعي يعملون بشكل صحيح، يجب عليك إعداد بيئتهم بالطريقة الصحيحة حتى يتبعوا العملية بالفعل.
00:00:32وسوف نستعرض جميع الخطوات التي تحتاج لاتخاذها قبل أن تبدأ حتى في البناء.
00:00:36التخطيط لمتطلباتك بشكل صحيح هو أهم شيء تقوم به قبل كتابة أمر واحد.
00:00:41هذا هو الجزء الذي ستحتاج لقضاء الوقت فيه مهما بلغت جودة النماذج.
00:00:45الآن هناك عدة طرق للتخطيط.
00:00:46يمكنك تخطيط تطبيقك باستخدام Claude code في وضع التخطيط، لكن تخطيطه يركز تقنياً وليس على المنتج.
00:00:52كما ذكرنا في الفيديو السابق، ومع تطور الوكلاء،
00:00:56فإن وضع التخطيط لا يحتاج لأن يكون مفصلاً أو تقنياً، بل يجب بدلاً من ذلك التركيز بشدة على جانب المنتج
00:01:01لأن النماذج الجديدة قوية ويجب أن يكون التخطيط مختلفاً عما كان عليه مع النماذج الأولى ذات القدرات المحدودة.
00:01:07لذا بدلاً من وضع التخطيط في Claude، يمكنك إنشاء وكيل آخر للمساعدة في تخطيط تطبيقك.
00:01:11إنه يحتوي على تعليمات للمساعدة في بناء وثيقة متطلبات منتج (PRD) سليمة مع قالب لتوجيه Claude حول المتطلبات بالضبط.
00:01:18بمجرد إعداد الوكيل، يمكنك إعطاء Claude أمراً لاستخدامه وتخطيط التطبيق الذي تريد بناءه.
00:01:23إنه يقوم فعلياً بتحميل وكيل المخطط ويستمر في طرح الأسئلة حتى يفهم جميع المتطلبات.
00:01:28يستمر في طرح الأسئلة حتى تصبح راضياً عن التخطيط.
00:01:32الآن لفهم الحد الأدنى من المنتج القابل للتطبيق (MVP)، تم تصميم الوكيل لطرح العديد من الأسئلة.
00:01:36وفي النهاية، سيسألك عما إذا كان هناك أي شيء آخر تحتاجه في تطبيقك.
00:01:40إذا كنت بحاجة، يمكنك إضافة الأشياء التي تريد من الوكيل تنفيذها.
00:01:43إذا كنت راضياً عن جميع الأسئلة وتعتقد أن الوكيل قد فهم الخطة، يمكنك فقط إخباره بأن هذا كل شيء.
00:01:49بعد جلسة الأسئلة والأجوبة، يقوم بإنشاء وثيقة PRD وحفظها في مجلد المشروع.
00:01:54تحتوي هذه الوثيقة على تفاصيل حول جميع المتطلبات التي ناقشتها.
00:01:57يتم تقسيم التنفيذ إلى مراحل وتتضمن جميع قرارات التصميم الرئيسية وكل ما هو مطلوب للتطبيق.
00:02:04الآن بعد أن نقحت التطبيق الذي تريد بناءه، الخطوة التالية هي تعريف ملف Claude.md بشكل صحيح.
00:02:10هذا الملف مهم لأنه يحتوي على جميع التعليمات التي تريد أن يتبعها وكيلك.
00:02:15تقوم بربط وثيقة PRD حتى يتمكن من الوصول لجميع متطلبات التطبيق مباشرة من هناك ولا تضطر لتكرار أي شيء هنا.
00:02:21يجب أن يحتوي هذا الملف فقط على الأشياء التي لا يعرفها الوكيل بدلاً من ذكر الأشياء التي يعرفها بالفعل.
00:02:27إنه يشير إلى القواعد التي تريد أن يتبعها المشروع.
00:02:30يمكنك إضافة اتفاقيات مشروعك وجميع التعليمات التي تريد من Claude اتباعها تحديداً أثناء تنفيذ التطبيق.
00:02:37النهج المثالي هو ألا تنشئ ملف Claude.md من أمر init بل تنشئه بنفسك
00:02:43لأن هذا الأمر ينشئ الملف بناءً على شكل الكود الحالي، وليس على ما يحتاج لمعرفته فعلياً.
00:02:49لكن هذا الملف ليس ملفاً يكتب مرة واحدة ويُنسى.
00:02:53عليك الاستمرار في إضافة أشياء إليه حتى يتمكن من تحسين عملية بناء التطبيقات تدريجياً أثناء عملك.
00:02:58الآن كما تحدثنا في الفيديو السابق، يتم تحميل هذا الملف مرة واحدة ويبقى في السياق للأبد، ليكون بمثابة دليل إرشادي أثناء العمل.
00:03:05لذا تأكد من أن هذا الملف لا يحتوي على أشياء غير ضرورية أو خاصة بمنطقة واحدة من التنفيذ.
00:03:12الأشياء التي تحتاج لإضافتها لهذا الملف هي أفضل الممارسات التي سيتبعها مشروعك، واتفاقيات البرمجة، وأسلوب الكتابة،
00:03:19وأشياء مماثلة ولكن ليس الأشياء التي يمكنه اكتشافها بنفسه مثل كيفية هيكلة المشروع.
00:03:24لأجل ذلك، يمكنه قراءة هيكل الملفات وفهمه بنفسه.
00:03:28لذا خذ وقتك عند كتابة هذا الملف وتأكد من أنه مصمم خصيصاً لاحتياجاتك ولمشروعك قبل البدء فعلياً في تنفيذ التطبيق.
00:03:36الشيء التالي الذي ستقوم بإعداده هو مهاراتك ووكلاءك وأي MCP تريد استخدامه في مشروعك، كل ذلك قبل البناء الفعلي.
00:03:42توصيل الـ MCPs أسهل.
00:03:44يمكنك فقط توصيل أي خدمة خارجية تريد أن يصل إليها الوكيل وتثبيتها عن طريق تشغيل أوامر التثبيت الخاصة بها.
00:03:50على سبيل المثال، أردنا بناء الجزء الخلفي (backend) على Superbase لذا قمنا بتوصيل Superbase MCP بوكيلنا في المشروع.
00:03:57إذا كنت تستخدم Shad CN UI لمكونات واجهة المستخدم وPlaywright لاختبار المتصفح،
00:04:01يجب أن تكون جميعها متصلة قبل بناء التطبيق حتى يتمكن الوكلاء من الوصول لهذه الأدوات أثناء البناء.
00:04:07لكن كانت تلك فقط لتوصيل الخدمات الخارجية، وتحتاج أيضاً لتهيئة الوكلاء.
00:04:12يمكنك تهيئة عدد الوكلاء الذي تحتاجه.
00:04:14لديك بالفعل وكيل مخطط مخصص للتخطيط.
00:04:16يمكنك أيضاً إنشاء وكيل مهام (commit agent) يكون مسؤولاً عن الحفظ (committing)، وإجراء الفحوصات المسبقة، واتباع رسائل الحفظ التقليدية.
00:04:23يمكن أن يكون لديك وكيل إعادة هيكلة (refactoring agent) يقوم بإعادة هيكلة الكود وتحسين الأداء بشكل عام.
00:04:28ويمكن أن يكون لديك وكيل تحقق يستخدم أدوات Playwright MCP حتى يتمكن من التحقق مما إذا كانت واجهة المستخدم وتدفق المستخدم يعملان كما هو مقصود.
00:04:39الآن بعيداً عن الوكلاء، تحتاج أيضاً لتهيئة المهارات.
00:04:42يمكنك إنشاء أي عدد تحتاجه من المهارات، ويمكنك إنشاؤها بسهولة باستخدام Skill Creator المتاح على مستودع GitHub المفتوح المصدر.
00:04:49يمكنك إضافة أي عدد تريده من المراجع وتضمين نصوص برمجية حتى يتمكن من تشغيل النص مباشرة واستخدام مخرجاته.
00:04:55للتمييز بين متى تستخدم الوكلاء ومتى تستخدم المهارات، قم بتنفيذ جميع تدفقات العمل المتكررة التي تحتاج لتوجيه ومراجع كمهارات.
00:05:04على سبيل المثال، يمكنك إنشاء مهارة للواجهة الأمامية (front-end) لأنها تدفق عمل متكرر ويجب أن تتبع إرشادات مخصصة باستمرار.
00:05:11استخدم الوكلاء للمهام التي تحتاج لنافذة سياق (context window) مخصصة.
00:05:14يمكنك أيضاً استخدام مهارة الواجهة الأمامية مفتوحة المصدر التي يستخدمها منشئ Claude code نفسه بنشاط.
00:05:20تحتاج أيضاً لإضافة قواعد خاصة بالمسارات لجوانب معينة من تطبيقك.
00:05:23تحدد هذه القواعد المسار الذي تنطبق عليه وتتضمن جميع التعليمات اللازمة لتنفيذ ذلك الجزء المحدد.
00:05:29يمكنك تهيئة ما تشاء من هذه القواعد وربطها أيضاً في ملف Claude.md ليعرف الوكيل أنه يجب اتباع هذه التعليمات.
00:05:36كما ذكرنا سابقاً، ملف Claude.md للمبادئ العامة، ولهذا توجد قواعد خاصة بالمسارات لأجزاء محددة ليعرف الوكيل ما يجب فعله لكل تنفيذ.
00:05:46نحن نغطي كل هذه الإعدادات وأكثر حول بناء المنتجات بالذكاء الاصطناعي على هذه القناة، لذا إذا أردت رؤية المزيد، اشترك وتابع الفيديوهات القادمة.
00:05:54ولكن حتى مع كل هذه التعليمات الإيجابية، لا تزال هناك فجوة.
00:05:58الوكلاء يميلون للعمل وقد ينفذون أشياء تتجاوز ما تحدده قيودك الإيجابية.
00:06:03لذلك، تحتاج لإخبار الوكيل صراحة بما لا ينبغي عليه فعله.
00:06:06يمكنك إنشاء هذا الملف في مجلد docs الخاص بك وربطه في Claude.md ليعرف الوكيل بوجود هذه القيود.
00:06:12يجب أن يحتوي على جميع التعليمات المصممة للمشروع، مع تحديد كل شيء لا تريد من الوكيل إنشاءه.
00:06:19القيود السلبية مهمة لأن المواصفات الإيجابية تترك فجوة ضمنية، والقيود السلبية تغلق تلك الفجوة، مما يزيل الغموض ويمنع الوكيل من التجربة حيث لا ينبغي.
00:06:29إنها تعطي هدفاً أوضح لما لا يجب أن تبدو عليه المخرجات.
00:06:32على سبيل المثال، إذا كنت لا تريد أن يتبع الذكاء الاصطناعي مزيج الأرجواني أو الأزرق والأبيض الافتراضي، اذكر صراحة أنك لا تريد ذلك.
00:06:41ولكن قبل المضي قدماً، لنستمع إلى كلمة من راعينا، Way in Video.
00:06:44إذا كنت تعمل مع فيديوهات طويلة، فأنت تعرف المعاناة. ساعات من البحث في اللقطات للعثور على لحظة جيدة واحدة، ثم المزيد من الوقت لتحريرها.
00:06:52Way in Video يحل كل ذلك. إنها منصة فيديو ذكاء اصطناعي تفهم الفيديو الخاص بك بالفعل.
00:06:56مهارة القص بالذكاء الاصطناعي الخاصة بهم على OpenClaw تأخذ أي فيديو طويل، وتجد أكثر اللحظات انتشاراً، وتعيد تأطيرها رأسياً وتضيف ترجمات.
00:07:04لا برمجة، لا إعدادات. فقط قم بتشغيل المهارة وستكون مقاطعك جاهزة للنشر. هكذا ببساطة.
00:07:08إذا كنت تريد شيئاً محدداً، يمكنك البحث داخل أي فيديو باستخدام لغة بسيطة. فقط اكتب "رد فعل مضحك" أو "أفضل اقتباس" وسينتقل إليه مباشرة.
00:07:16كما أنها تتعامل مع ملخصات الفيديو وتدوين النصوص مع تسميات المتحدثين. مثالية للبودكاست، والمحاضرات، والبث المباشر.
00:07:22سواء كنت تعيد استخدام المحتوى أو تؤتمت سير عملك، فإن Way in Video يوفر لك ساعات كل أسبوع.
00:07:27توقف عن إضاعة الوقت في التحرير اليدوي. انقر على الرابط في التعليق المثبت للبدء.
00:07:32الآن هذا شيء تستخدمه معظم أطر عمل الذكاء الاصطناعي بشكل أو بآخر، وهو استخدام وثائق متعددة لأغراض مختلفة.
00:07:38لكن الجوهر وراء كل تلك الوثائق هو وثيقة التقدم والتعلم.
00:07:42ملف التقدم حيوي لأنه عندما تعمل على تطبيق واسع النطاق بميزات متعددة، يفقد الوكيل تتبع الميزات التي نفذها والميزات التي لم يعمل عليها بعد.
00:07:52بدون هذا الملف، يضطر الوكيل للعودة وقراءة التنفيذ ومقارنته بالوثائق لمعرفة ما تم إنجازه.
00:07:58يخلق ذلك عبئاً إضافياً ويضيع الوقت والرموز (tokens).
00:08:01لذا أنشئ ملف تقدم حيث يمكن للوكيل النظر لمكان واحد ومعرفة وضع الأمور بالضبط.
00:08:07لكن تتبع التقدم وحده لا يكفي لأن الوكيل يحتاج أيضاً لمعرفة ما حدث من خطأ.
00:08:11لذلك، تحتاج أيضاً لملف دروس مستفادة حيث يسجل الوكيل أخطاءه، وسببها، وكيف أصلحها.
00:08:17بهذه الطريقة، عندما يواجه موقفاً مشابهاً لاحقاً، لا يرتكب نفس الخطأ مرتين.
00:08:22الآن بما أن كلا هذين الملفين من المفترض تحديثهما بنشاط أثناء قيام الوكيل بتنفيذ التطبيق،
00:08:26تحتاج لتوجيه الوكيل صراحة في ملف Claude.md ليستمر في الإضافة لهذه الملفات، مما يحسن قاعدة معرفته أثناء البناء.
00:08:34هذان الملفان هما الأكثر أهمية واللذان يحتاجهما كل إعداد.
00:08:38يمكنك استخدام هذه الملفات عندما تبني إعداد البرمجة الخاص بك.
00:08:41لقد صنعنا سابقاً فيديو يتحدث عن كيفية بناء أطر العمل بنفسك، والذي يمكنك مشاهدته على القناة.
00:08:46لكن إذا كنت لا تريد عناء إعداد إطار العمل الخاص بك،
00:08:49يمكنك فقط الاعتماد على أطر عمل البرمجة لأنها تستخدم آليات مختلفة للقيام بذلك بالضبط وبإمكانك تنفيذها مباشرة.
00:08:56خطأ شائع آخر هو تنفيذ الاختبارات فقط في نهاية التطوير.
00:09:00هذا أمر إشكالي لأنه إذا طلبت من وكيل كتابة وتنفيذ اختبارات بعد بناء الميزات،
00:09:05فلن تكون الاختبارات فعالة كما لو كتبت مسبقاً.
00:09:09عند كتابة الاختبارات، يجب أن يرجع الوكيل إلى وثيقة PRD التي أنشأتها، وبناءً عليها يستنتج كيف يجب أن تعمل الوظيفة.
00:09:16يجب على الوكيل بعد ذلك كتابة اختبارات من هذه المتطلبات المستنتجة،
00:09:19مما يعني فعلياً الهندسة العكسية للوظيفة وتوقع الأماكن التي قد يخطئ فيها التطبيق بناءً على PRD.
00:09:24بمجرد جاهزية الاختبارات، يمكنك تشغيلها في النهاية للتحقق مما إذا كان التنفيذ يلبي المتطلبات.
00:09:29السبب وراء كتابة الاختبارات أولاً هو أنه إذا نفذتها لاحقاً، فإن الوكيل سيعرف فقط ما تم تنفيذه بالفعل.
00:09:35سيقوم بتحسين الاختبارات للميزات كما هي موجودة، وليس للوظائف كما هي مطلوبة في المواصفات.
00:09:41قد يتسبب هذا في تفويت اختبار ميزات تم تحديدها ولكن لم يتم تنفيذها بشكل صحيح.
00:09:46لأن الوكيل يحسن تجاه النهج المنفذ، فقد يقصر في الاختبار الشامل،
00:09:50مما يضيع حالات استثنائية (edge cases) كان يمكن اكتشافها لو كانت الاختبارات مستمدة مباشرة من المواصفات.
00:09:55لا ينبغي إعطاء الوكيل تعليمات مفتوحة مثل "اختبر التطبيق" لأن Claude في هذه الحالة سيقوم فقط بالتحسين لأجل التنفيذ.
00:10:02بدلاً من ذلك، قم بتنفيذ اختبارات سليمة موجهة بالمواصفات ليعرف الوكيل بالضبط ما الذي يجب تحسينه.
00:10:07أيضاً، إذا كنت تستمتع بمحتوانا، فكر في الضغط على زر الدعم لأنه يساعدنا في إنشاء المزيد من هذا المحتوى والوصول للمزيد من الناس.
00:10:14مشكلة أخرى يواجهها الكثيرون أثناء تطوير التطبيقات هي نقص تتبع المشكلات مسبقاً.
00:10:19بدونها، تتراكم المشكلات دون سجل لسببها أو وقت بدئها، ومع توسع التطبيق، يصعب تتبعها.
00:10:26لذلك، يعد الاحتفاظ بسجلات مناسبة أثناء الاختبار أمراً بالغ الأهمية.
00:10:29يستخدم الكثيرون GitHub لهذا الغرض، وهو منصة ممتازة لتتبع وإدارة المشكلات.
00:10:34دمجها مع رسائل Git commit منظمة بشكل جيد يوفر توجيهاً لـ Claude حول ما تم فعله في كل عملية حفظ ويسمح له بتتبع تقدمه.
00:10:42إحدى أفضل ميزات Git هي أنه إذا أدى تغيير لتعطل الكود، يمكنك التراجع عن عمليات الحفظ.
00:10:47وإذا كنت تريد اختبار شيء تجريبي، يمكنك استخدام الـ work tree للقيام بذلك في عزلة.
00:10:51يمكنك تهيئة إعداداتك بحيث يقوم الوكيل بالحفظ بعد كل تنفيذ باستخدام رسائل مفصلة للحفاظ على الوضوح.
00:10:58لكن GitHub يعمل بشكل جيد للمستخدمين التقنيين، وقد يجد أعضاء الفريق غير التقنيين صعوبة في تقديم المشكلات.
00:11:03لذلك، بالنسبة لهم، يعد ربط الوكيل بأداة إدارة مشاريع مثل Trello أو Notion أمراً مثالياً.
00:11:08يسمح هذا بتسجيل المشكلات وتتبع التقدم والتعاون في الإصلاحات.
00:11:12يجب عليك توصيل الـ MCP للأداة المعنية حتى يتمكن الوكيل من الوصول إليها وتتبع المشكلات وتحريكها عبر اللوحات وإدارة التقارير بكفاءة.
00:11:20تحتاج أيضاً لإضافة تعليمة في Claude.md تحدد أنه يجب على الوكيل استخدام Notion MCP لتتبع الأخطاء والمشكلات بشكل صحيح.
00:11:28إعداد هذا في البداية لا يقدر بثمن مع توسع المشروع وبدء عدة أشخاص في التطوير معاً، لضمان تسجيل وتتبع كل شيء بكفاءة.
00:11:36ولكن حتى لو كان تطبيقك يعمل بشكل مثالي في الاختبار، فإن الكود الذي ينشئه الذكاء الاصطناعي ليس مصمماً بطبيعته للتعامل مع عدة مستخدمين في آن واحد.
00:11:43هذا هو السبب في أن الكثيرين يجدون تطبيقات الذكاء الاصطناعي ضعيفة الأداء في مرحلة الإنتاج.
00:11:47لذلك، تحتاج للاستعداد لذلك أيضاً.
00:11:49إذا كان لديك تقدير، يمكنك إخبار وكيلك بعدد المستخدمين المتوقع وأن عدة مستخدمين سيستخدمون التطبيق في نفس الوقت.
00:11:56يجب على الوكيل حينها كتابة حالات الاختبار لاختبار ضغط التحميل بناءً على هذه المعلومات.
00:12:01هناك عدة أدوات اختبار يمكنك استخدامها ويمكنك اختيار ما يناسب متطلباتك.
00:12:05لقد استخدمنا K6 لتطبيق Next.js لأنه سهل التنفيذ ومناسب لمتطلباتنا.
00:12:10يمكنك أيضاً استخدام وضع التخطيط في Claude هنا لرسم نهج متعدد للتطبيق لأننا هنا نحتاج لخطة تقنية مفصلة.
00:12:17يخطط Claude بناءً على PRD والعدد التقريبي للمستخدمين الذين تتوقع استخدامهم للتطبيق في وقت واحد.
00:12:23يطرح Claude عدة أسئلة من منظورات مختلفة ويوضح المشكلات المحتملة التي قد تنشأ في الإنتاج.
00:12:29يساعد ذلك التطبيق على التعطل بشكل لائق حتى لو حدثت مشاكل ويضمن تحسين تجربة المستخدم.
00:12:34باستخدام هذا الوضع، يمكنك توضيح نيتك وجعل الوكيل يخطط للتوسع أيضاً.
00:12:39تصبح هذه الخطة هي القطعة الأخيرة في نقل تطبيقك من فكرة إلى منتج جاهز للإنتاج.
00:12:43الآن جميع هؤلاء الوكلاء والمهارات المذكورة هنا متاحة في AI Labs Pro لهذا الفيديو ولجميع فيديوهاتنا السابقة حيث يمكنك تحميلها واستخدامها لمشاريعك.
00:12:53إذا وجدت قيمة فيما نقوم به وأردت دعم القناة، فهذه هي الطريقة الأفضل للقيام بذلك.
00:12:57الرابط موجود في الوصف.
00:12:59بذلك نصل إلى نهاية هذا الفيديو.
00:13:00إذا كنت ترغب في دعم القناة ومساعدتنا في الاستمرار في تقديم مثل هذه الفيديوهات، يمكنك القيام بذلك باستخدام زر Super Thanks أدناه.
00:13:07كما هو الحال دائماً، شكراً للمشاهدة وأراكم في الفيديو القادم.

Key Takeaway

بناء برمجيات ناجحة باستخدام وكلاء الذكاء الاصطناعي يتطلب تهيئة بيئة عمل صارمة تعتمد على وثيقة متطلبات منتج (PRD) مفصلة وقيود سلبية محددة قبل كتابة سطر كود واحد.

Highlights

إعداد ملف Claude.md بشكل يدوي يتفوق على أمر التلقائي init لأنه يركز على القواعد التوجيهية بدلاً من مجرد وصف هيكل الكود الحالي.

توفير وثيقة تقدم (Progress File) يمنع استهلاك الرموز (Tokens) الزائد عبر تزويد الوكيل بمرجع واحد يوضح الميزات المكتملة والمتبقية.

استخدام بروتوكول Model Context Protocol (MCP) يربط وكلاء البرمجة بأدوات خارجية مثل Supabase لقواعد البيانات وPlaywright للاختبارات الآلية.

كتابة الاختبارات البرمجية بناءً على وثيقة متطلبات المنتج (PRD) قبل بدء التنفيذ تضمن كشف الحالات الاستثنائية التي قد يتجاهلها الوكيل عند التحسين للكود الموجود بالفعل.

دمج أدوات إدارة المشاريع مثل Trello أو Notion عبر MCP يسهل تتبع المشكلات للأعضاء غير التقنيين ويضمن توثيق الأخطاء وإصلاحها بكفاءة.

Timeline

التخطيط المرتكز على المنتج ووثيقة PRD

  • التخطيط الصحيح للمتطلبات يمثل المرحلة الأكثر استهلاكاً للوقت والأهمية في دورة تطوير البرمجيات بالذكاء الاصطناعي.
  • استخدام وكيل مخصص للتخطيط ينتج وثيقة متطلبات منتج (PRD) شاملة تخزن في مجلد المشروع لتقليل الغموض التقني.
  • النماذج الحديثة تتطلب تخطيطاً يركز على رؤية المنتج والوظائف بدلاً من التفاصيل التقنية الدقيقة التي يمكن للوكيل استنتاجها.

تتحول العمليات التقليدية التي وضعت على مدار 60 عاماً من تمكين البشر إلى تمكين وكلاء الذكاء الاصطناعي من العمل بنفس الكفاءة. يقوم وكيل المخطط بطرح أسئلة متكررة حتى الوصول لخطة مرضية تغطي الحد الأدنى من المنتج القابل للتطبيق (MVP). تنقسم المخرجات النهائية إلى مراحل تنفيذ محددة وقرارات تصميم رئيسية تسهل عملية البناء اللاحقة.

إعداد ملفات التوجيه والقيود السلبية

  • ملف Claude.md يعمل كدليل إرشادي دائم في سياق الوكيل ويجب أن يحتوي على القواعد والاتفاقيات التي لا يمكن اكتشافها تلقائياً.
  • القيود السلبية تغلق الفجوات الضمنية في المواصفات وتمنع الوكيل من تجربة حلول غير مرغوب فيها مثل أنماط التصميم الافتراضية.
  • ربط وثيقة PRD بملف Claude.md يلغي الحاجة لتكرار المتطلبات ويحافظ على نظافة سياق العمل.

يجب تحديث ملف Claude.md باستمرار ليعمل كمرجع لأفضل ممارسات المشروع وأسلوب البرمجة المطلوب. تبرز أهمية القيود السلبية في إزالة الغموض وتحديد ما لا يجب فعله صراحة، مثل تجنب ألوان معينة في واجهة المستخدم. يتم ربط القواعد الخاصة بمسارات معينة (Path-specific rules) بهذا الملف لضمان اتباع تعليمات مخصصة لكل جزء من التطبيق.

تهيئة الوكلاء والمهارات وMCP

  • توزيع المهام بين وكلاء متخصصين للحفظ (Commit) وإعادة الهيكلة والتحقق يرفع من جودة الكود النهائي.
  • تخصيص المهارات (Skills) لتدفقات العمل المتكررة مثل تطوير الواجهة الأمامية يوفر مراجع ثابتة للوكيل.
  • ربط الخدمات الخارجية مثل Supabase وShad CN UI يتم قبل البدء في البناء لضمان وصول الوكلاء للأدوات اللازمة.

يتم التمييز بين الوكلاء والمهارات بناءً على الحاجة لنافذة سياق مخصصة، حيث تستخدم المهارات للعمليات التي تتطلب توجيهاً مستمراً. يسهل Skill Creator المتاح على GitHub إنشاء نصوص برمجية مخصصة يمكن للوكيل تشغيلها مباشرة. تضمن هذه التهيئة المسبقة وجود نظام بيئي متكامل يدعم الوكلاء أثناء تنفيذ المهام المعقدة.

التوثيق الحي والتعلم من الأخطاء

  • ملف التقدم (Progress File) يحمي الوكيل من فقدان تتبع الميزات المنفذة في المشاريع واسعة النطاق.
  • سجل الدروس المستفادة يمنع تكرار الأخطاء البرمجية عبر توثيق أسباب الفشل وطرق الإصلاح.
  • توجيه الوكيل صراحة لتحديث هذه الملفات يحسن قاعدة معرفته بشكل تراكمي أثناء عملية البناء.

بدون ملف التقدم، يضطر الوكيل لإعادة قراءة الكود بالكامل لمقارنته بالمتطلبات، مما يهدر الوقت والرموز. يعمل ملف الدروس المستفادة كذاكرة للمشروع تمنع الوكيل من الوقوع في نفس المآزق التقنية مرتين. تشكل هذه الملفات الحية العمود الفقري لأي إعداد برمجي يعتمد على الذكاء الاصطناعي لضمان الاستمرارية والدقة.

الاختبار الاستباقي وتتبع المشكلات

  • كتابة الاختبارات بناءً على المواصفات قبل الكود تمنع الوكيل من التحسين لمجرد التنفيذ الموجود.
  • دمج أدوات مثل Trello أو Notion عبر MCP يتيح تتبع الأخطاء بكفاءة في بيئات العمل الجماعية.
  • رسائل Git commit المنظمة توفر سجلاً زمنياً واضحاً يسمح بالتراجع عن التغييرات التي تعطل النظام.

يؤدي تأجيل الاختبارات لنهاية التطوير إلى بناء اختبارات تناسب الكود المنفذ وليس المتطلبات الأصلية، مما قد يخفي عيوباً وظيفية. يوفر استخدام GitHub أو Notion وسيلة لتنظيم المهام وتتبع الأخطاء بشكل مركزي. تضمن هذه الممارسات الحفاظ على جودة البرمجيات مع توسع المشروع وزيادة عدد المطورين المشاركين.

جاهزية الإنتاج واختبارات الحمل

  • كود الذكاء الاصطناعي يحتاج لتهيئة إضافية للتعامل مع تعدد المستخدمين المتزامن في بيئة الإنتاج.
  • أدوات مثل K6 توفر إمكانية اختبار ضغط التحميل للتطبيقات المبنية بـ Next.js لضمان استقرارها.
  • وضع التخطيط في Claude يساعد في رسم استراتيجيات تقنية للتوسع والتعامل مع الأعطال بشكل لائق.

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

Community Posts

View all posts