ساعد Claude Code في بناء نظام CRM عملي من 46 ألف سطر — ويوجد دليل بالفعل

نُشِرت على منصة Habr AI دراسة حالة مفصلة حول كيفية قيام فريق من شخصين ببناء نظام إدارة علاقات العملاء تجاري بالكامل تقريباً باستخدام Claude Code. خلال حوالي شهر ونصف، أنتجوا 46 ألف سطر من الكود ومنتجاً يعمل بشكل فعلي ومجموعة من القواعد التي بدونها يتحول هذا النمط من العمل بسرعة إلى فوضى.

ما الذي بنوه

يصف المؤلفان ليس نموذجاً تعليمياً، بل نظام إدارة علاقات عملاء يعمل بكفاءة لمعالجة الطلبات الواردة وإدارة الصفقات. يستطيع النظام الرد التلقائي على رسائل البريد الإلكتروني وإنشاء المهام وتحريك العملاء عبر مسار التحويل. كتب المشروع شخصان: أحدهما جمع بين دوري مدير ومحلل، وجمع المهام من المكالمات الفيديوية عبر ReadAI وحررها في Jira من خلال MCP؛ والآخر أدار عملية التطوير والتنفيذ والاختبار نفسها.

اختاروا NestJS و NextJS و ShadCN UI و PostgreSQL كمجموعة تقنية. الخلاصة الأساسية من هذه التجربة بسيطة: ما هو مثير للإعجاب ليس الرقم 46 ألف سطر بحد ذاته، بل أن العميل يستخدم المنتج بالفعل. وهذا فرق مهم في مقابل التشكك المعتاد تجاه الترميز العشوائي، الذي غالباً ما يرتبط إما بعروض نهاية الأسبوع أو بإنتاج معجل للديون التقنية.

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

كيف نظموا العملية

كان الأثر الرئيسي للفريق ملف claude.md قصير - ليس كومة معرفة، بل نقطة دخول تحتوي على وصف المشروع والمجموعة التقنية وروابط الوثائق والقواعد الأساسية. تم نقل كل شيء آخر إلى ملفات md منفصلة حسب الوحدات: الصفقات ومعالجة البريد الإلكتروني وواجهات برمجية التطبيقات والأجزاء الأخرى من النظام. بالنسبة للواجهة الخلفية وقاعدة البيانات والمجالات الأخرى، أنشأوا "وكلاء" خاصين بهم على شكل تعليمات تتضمن الأنماط والقيود والأخطاء النموذجية. الفكرة هي أن يقرأ Claude فقط السياق المطلوب في تلك اللحظة، بدلاً من إهدار الرموز على المشروع بأكمله دفعة واحدة.

• ملف claude.md قصير يتضمن أهم المعلومات
• ملفات md منفصلة للوحدات الكبرى
• تعليمات متخصصة للواجهة الخلفية وقاعدة البيانات
• سياق واحد لمهمة واحدة
• مراجعة إلزامية بعد الجيل

القاعدة الثانية هي عدم مزج المهام في نافذة واحدة. ينصح المؤلفان بالالتزام بمخطط "سياق واحد = مهمة واحدة" وإجراء clear بعد الانتهاء واستخدام resume للعودة. السبب هو أنه عند امتلاء السياق، يضغط Claude السجل ويفقد التفاصيل في الوقت الأسوأ. للأعمال الكبيرة، كانوا يفعلون تفعيل plan mode لتقسيم التنفيذ إلى مهام فرعية مستقلة. وفقاً لتقديرهم، حتى الاشتراك الأساسي بقيمة 20 دولاراً يكفي لمدة 3-5 ساعات من العمل النشط إذا كانت الوثائق وبنية المشروع جاهزة بالفعل.

حيث تنشأ المشاكل

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

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

بالنسبة للمهام المعمارية المعقدة، استخدموا Sequential Thinking للسماح للنموذج أولاً بالمرور عبر سلسلة من التفكير قبل كتابة الكود مباشرة. للتنقل عبر قاعدة كود كبيرة، ثبت أن Serena مفيدة، مما يوفر السياق في البحث عن الملفات.

"الشيء الرئيسي هو فهم ما تريد الحصول عليه كمخرج وعدم توليد الفوضى."

ماذا يعني هذا

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