كيفية تكوين Claude Code بواسطة مطور YADRO باستخدام Spec-Driven Development

المبرمج والمهندس المعماري في YADRO دانيل بودولسكي يعمل بمنهجية Spec-Driven Development منذ تسعة أشهر ويدير وكلاء الذكاء الاصطناعي الذين يكتبون الكود بدلاً عنه. يسمي نفسه ليس مبرمج vibe coding، بل مهندس — ويشرح السبب. هذا هو المقال الأول من سلسلته حول تنظيم مساحة عمل مطور SDD: دراسة إعداد Claude Code الأساسي للتبديل السريع بين النماذج دون إعادة تحميل.

SDD مقابل Vibe Coding

Vibe coding هو عندما يصف المطور مهمة للذكاء الاصطناعي وينظر إلى ما حدث ويكرر "حسب الإحساس". يحظى النهج بشعبية بالضبط لأنه يعمل بسرعة ولا يتطلب أي تحضير مسبق. Spec-Driven Development مختلف بشكل أساسي. أولاً، يتم إنشاء مواصفات كاملة: المتطلبات والعمارة وسلوك النظام والحالات الحدية. فقط بعد ذلك يبدأ وكيل الذكاء الاصطناعي في العمل من الوثيقة كمواصفات تقنية. يشكل المطور البنية ويتخذ القرارات المعمارية، بينما ينفذ الذكاء الاصطناعي التفاصيل ويملأ الكود. يصر بودولسكي على أن نهجه "أكثر شمولاً من مجرد التحدث مع الذكاء الاصطناعي". يعيد SDD انضباط الهندسة إلى منطقة بدأت تختفي بسبب سرعة أدوات الذكاء الاصطناعي — المتطلبات والتصميم والتنفيذ والتحقق. تغير المنفذ، لكن العملية نفسها تبقى هندسية. هذا ما يميز SDD عن vibe coding: ليس الأداة، بل المنهجية.

إعداد Claude Code لعدة مشاريع

المهمة المركزية للمقال هي كيفية التبديل بين النماذج في Claude Code دون إعادة تحميل، بشكل فردي لكل مشروع. للوهلة الأولى تفصيل، في الممارسة — عنق الزجاجة الخطير لمن يدير عدة مستودعات بشكل متزامن. الإعداد العام القياسي للنموذج غير مناسب في هذه الحالة. تفرض المشاريع المختلفة متطلبات مختلفة: خدمة الإنتاج تحتاج إلى Opus برسم تفكير عميق والالتزام الصارم بالتعليمات، النموذج الأولي أو المهمة الروتينية تعمل بشكل جيد مع Sonnet أو Haiku. إذا تطلب كل انتقال بين المشاريع إعادة إعداد يدوية وإعادة تشغيل الوكيل، يبدأ المطور تدريجياً في تجنب تغيير النموذج — ويختار نموذج "عام" بدلاً من الأمثل.

مبادئ الإعداد الرئيسية:

• `CLAUDE.md` في جذر المشروع — يتم عزل النموذج والسياق بالكامل على مستوى المستودع
• أمر `/model` يبدل النماذج على الفور دون إعادة تشغيل الجلسة الحالية
• `settings.json` على مستوى المشروع يخزن ملفات تعريف الوكلاء والأذونات ومجموعات الأدوات
• تمييز ملفات override المحلية بين إعدادات التطوير والإنتاج
• متغيرات البيئة تسمح بالتحكم في النموذج عبر CI/CD بدون تعديل ملفات الإعداد

لماذا سرعة التبديل تغير الجودة

مع Spec-Driven Development، يستخدم مشروع واحد بشكل تسلسلي عدة نماذج في مراحل مختلفة. إنشاء مواصفة يتطلب نموذج قوي برسم تفكير قوي وإجابات مفصلة. التنفيذ من مواصفة جاهزة يحتاج نموذج سريع وموثوق — احتمال أقل للانحراف عن المهمة. للمراجعة النهائية، يكون ملف تعريف آخر مطلوب مرة أخرى. إذا كان التبديل يستغرق ثلاثين ثانية ويتطلب معالجة يدوية، يبدأ المطور تدريجياً في تجنب تغييرات النموذج. هذا يسوء كلاً من السرعة والجودة — خاصة في مرحلة كتابة المواصفات، حيث يكون التفكير حرجاً.

"نهجي للعمل أكثر شمولاً من مجرد التحدث مع الذكاء الاصطناعي", — دانيل

بودولسكي، YADRO.

ستستمر السلسلة. ستغطي المقالات التالية تنسيق عدة وكلاء بالتوازي وإدارة السياق وبنية المواصفات نفسها.

ما يعنيه هذا

Spec-Driven Development يصبح تدريجياً اختصاص هندسي منفصل. بينما يتعلم معظم المطورين vibe coding، ينتقل البعض إلى منهجيات صارمة: التوثيق والمواصفات والوكيل والتحقق. تحليل إعداد Claude Code من قبل مهندس معماري في YADRO هو من أوائل المواد المنهجية باللغة الروسية حول هذا الموضوع. تستحق السلسلة المتابعة لمن لا يزالون يعملون مع أدوات الذكاء الاصطناعي بشكل حدسي.