الكود رخيص. المواصفات هي الأصل.
أصبح الكود مجرد أداة رخيصة. القيمة الحقيقية تكمن الآن في المواصفات.
أقضي وقتاً أقل في كتابة خطط التنفيذ يدوياً، وأقضي وقتاً أطول في التصميم. الذكاء الاصطناعي يجعل هذا ممكناً. هو لا يحل محل التقدير الهندسي، بل يغير مكان استخدامه.
أترك للذكاء الاصطناعي صياغة المواصفات والكود. وظيفتي الآن هي تحديد القصد وتحديد القيود. الكتابة هي الجزء الأقل قيمة في العملية.
مواصفاتي ليست للبشر الذين يقرؤون الويكي، بل لجلسة الذكاء الاصطناعي التالية. يجب أن تسمح للذكاء الاصطناعي بمواصلة العمل دون الحاجة لشروحات جديدة.
تركز المواصفات الفعالة على:
- المتطلبات
- القيود
- معايير القبول
- خطوات التحقق
هي مصممة ليتم تنفيذها، وليس لمجرد قراءتها. الجمهور المستهدف هو المساهم التالي، سواء كان بشراً أو وكيل ذكاء اصطناعي (AI agent).
الهندسة الحديثة هي مشكلة إدارة قيود. يعمل الذكاء الاصطناعي بشكل جيد مع القيود إذا قمت بتحديدها بوضوح. يتبع سير عملي هذه المراحل: القصد ← مواصفات الذكاء الاصطناعي ← مراجعة بشرية ← خطة تنفيذ الذكاء الاصطناعي ← مراجعة بشرية ← توليد الكود بواسطة الذكاء الاصطناعي ← الاختبار
أنا أقدم الهدف، والمتطلبات، والحدود. يقوم الذكاء الاصطناعي بصياغة المواصفات. أقوم بمراجعتها. يقوم الذكاء الاصطناعي بصياغة الخطة. أقوم بمراجعتها. عندها فقط نقوم بتوليد الكود.
أكتب أقل، لكني أراجع بدقة أكبر. هنا تكمن القيمة الهندسية.
المواصفات الجيدة تحدد ما يجب أن يكون صحيحاً، وليس كيفية جعله صحيحاً. على سبيل المثال، يجب أن تنص مواصفات إعادة الهيكلة (refactoring) على ما يلي:
- لا يجوز لأي فئة (class) في طبقة التطبيق (application layer) الإشارة إلى تنفيذات الـ DAO.
- معايير القبول: انتهاكات الطبقات تؤدي إلى عدم وجود نتائج مطابقة أثناء عمليات البحث.
المهمة الأكثر أهمية هي تحديد القيود الحاملة للعبء (load-bearing constraints). وهي قواعد حاسمة مثل:
- استراتيجيات تهيئة قاعدة البيانات
- نماذج النشر
- حدود التكامل
إذا أغفلت هذه القيود، سينهار النظام.
جلسات الذكاء الاصطناعي مؤقتة، تأتي وتذهب. القيمة تأتي من الذاكرة المشتركة:
- المواصفات
- خطط التنفيذ
- سجلات قرارات الهندسة المعمارية (ADRs)
- الاصطلاحات
هذه الذاكرة تمنع انحراف التوثيق (documentation drift). عندما تروي ملفات README والكود وسجلات ADR قصصاً مختلفة، تنهار الثقة. يجب عليك مواءمتها مع الواقع.
يجب أن يعكس المستودع هذا الهيكل:
- CLAUDE.md: سير العمل وبوابات المراجعة.
- status.md: فهرس حي لجميع المواصفات والخطط.
- specs/: الـ "ماذا" والـ "لماذا".
- plan/: الـ "كيف".
- rules/: اتفاقيات البرمجة على مستوى الفئات.
- docs/adr/: سجلات غير قابلة للتغيير للقرارات الهامة.
يمكن للذكاء الاصطناعي توليد الكود. لكنه لا يستطيع تحديد القيود التي تهم عملك بشكل موثوق. هذه مسؤوليتك.
ابنِ معرفة قابلة للتنفيذ. ابدأ كل مشروع بذاكرة مشتركة، وليس بصفحة فارغة.
المصدر: https://dev.to/daniel_wu_cac679a2760ba0a/the-code-is-cheap-artifact-now-the-spec-is-the-asset-3b02
مجتمع تعلم اختياري: https://t.me/GyaanSetuAi