تخطّي إلى المحتوى
الذكاء الاصطناعي والوكلاء
العودة إلى الكتاباتالذكاء الاصطناعي والوكلاء

بناء مصنع برمجيات لوكلاء البرمجة الذكية (الاسم الرمزي: ديوان)

كيف أبني ديوان: مصنع برمجيات ذاتي الاستضافة يخطّط عمل وكلاء البرمجة مثل Claude Code و Codex ويوزّعه ويشرف عليه ويتحقق منه، بالعربية والإنجليزية.

أعمل يوميًا مع وكلاء البرمجة بالذكاء الاصطناعي Claude Code و Codex و opencode و Gemini في عملي ومشاريعي. كلٌّ منهم جيد وحده، لكن تشغيل عدة وكلاء في وقت واحد أمرٌ آخر.

لذلك أبني لهم مصنع برمجيات، اسمه الرمزي «ديوان». يدخل العمل من طرفٍ على هيئة خطة، ويبنيه الوكلاء على أجهزتي الخاصة، ثم يخرج من الطرف الآخر طلباتِ تغيير مراجَعةً ومختبَرة أوافق عليها من مكتبي أو من هاتفي.

المشكلة: وكلاء كثيرون بلا مصنع

في يوم عادي أبدأ مع عدد قليل من الوكلاء على مهام حقيقية، مثل Claude Code و Codex و opencode وغيرها. ثم يشغّل كلٌّ منهم وكلاءه الفرعيين، فتتحول المهام القليلة سريعًا إلى جلسات متوازية كثيرة في مشاريع العمل والمشاريع الشخصية. وهذا ما يبدو عليه الأمر اليوم:

  • نافذة طرفية لكل وكيل، ولا مكان واحد يُظهر ما يفعله كلٌّ منهم.
  • يبلغ وكيلٌ حدَّ استخدامه في منتصف المهمة، فيتوقف العمل حتى يتجدّد رصيده، حتى لو كان لدى وكيل آخر رصيد متاح.
  • حين أبتعد عن المكتب لا أستطيع الإجابة عن سؤال وكيل أو الموافقة على تغيير.
  • تُضبط المهارات والقواعد والإضافات لكل وكيل على حدة.
  • لا توجد رؤية مركزية لما استُهلك من الرموز والرصيد وما تبقّى.
  • كلمة «أُنجز» ادّعاء لا حقيقة: يقول الوكيل إن المهمة انتهت، وعليّ أن أتحقق بنفسي.

لا شيء من هذا مشكلةً في النماذج نفسها؛ فالنماذج جيدة. الناقص هو المصنع من حولها: خط الإنتاج الذي يخطّط ويوزّع ويشرف ويتحقق.

لماذا مصنع وليس مجرد ديوان؟

كان الديوان هو المكتب الذي تُسجَّل فيه أعمال الدولة وتُوزَّع ويُبتّ فيها، ومن هنا جاء الاسم الرمزي. لكن التسجيل والتوزيع نصف العمل فقط؛ فالمصنع يملك أيضًا خط إنتاج، ومراقبة جودة، ومشرفًا لا يتعب.

وهكذا يعمل ديوان:

  • الطلبات: يُسجَّل العمل على لوحة Agentic Scrumban على هيئة ملاحم وقصص ومهام لكلٍّ منها معايير قبول.
  • خط الإنتاج: موزّع محدَّد السلوك يُسلّم المهام الجاهزة إلى الوكيل المناسب، وأي وكيل يستطيع أن يتسلّم أي مهمة.
  • تبديل الورديات: حين يبلغ وكيلٌ حدّه يترك نقطة حفظ وملاحظة تسليم، ويُكمل مزوّد آخر العمل. والهدف ألا يتجاوز التوقف دقيقتين في المتوسط.
  • مراقبة الجودة: لا يصلني شيء إلا بعد نجاح فحوص CI كلها، ومراجعةٍ من وكيل آخر، ودليلٍ على كل معيار قبول.
  • مشرف الخط: لكل إجراء، من بدء التشغيل حتى الدمج، وضعٌ أحدّده بنفسي: إيقاف، أو سؤال، أو إبلاغ، أو تلقائي. والنظام هو من يفرضه، لا سطرٌ في تعليمات الوكيل.
  • غرفة التحكم: تطبيق لأجهزة Mac وآخر لأجهزة iPhone و iPad ورسائل عبر Telegram بحيث لا تستغرق أي موافقة أكثر من 30 ثانية من الهاتف.

لا يحلّ ديوان محلّ الوكلاء ولا محلّ منصّتي GitHub و GitLab بل يعمل فوقها ويمنحها ذاكرة مشتركة ومشرفًا ومجموعة قواعد.

مصنع برمجيات حقيقي من البداية إلى النهاية

يعمل ديوان كمصنع برمجيات حقيقي، ويتبع دورة تطوير حديثة كاملة من الفكرة حتى الإصدار: المتطلبات، والتصميم، والتخطيط، والبناء، والاختبار، والمراجعة الأمنية، وطلبات التغيير، والإصدار. ولكل مرحلة اختباراتها المؤتمتة، ويُكتب الكود وفق ممارسات OWASP للبرمجة الآمنة.

ولهذا يفيدك أيًّا كنت:

  • المطوّرون ومهندسو البرمجيات يحصلون على فريق وكلاء تحت الإشراف يتبع الممارسات التي كانوا سيصرّون عليها بأنفسهم.
  • ومن يبني منتجه بمساعدة الذكاء الاصطناعي دون خبرة برمجية واسعة (vibe coding) يكفيه أن يحمل الفكرة؛ ففي الوضع المستقل يتولى ديوان مسؤولية تحويلها إلى منتج حقيقي، وقد صُمّم ليتجنّب معظم الممارسات السيئة التي لا يكتشفها عادةً إلا من راكم خبرة طويلة في فرق ومجالات مختلفة.

وفي كل الحالات تبقى أنت المتحكّم: تختار مقدار ما يعمل وحده، وترى كل خطوة وتقدّمها، ويمكنك التدخل في أي لحظة لتتأكد أن النتيجة هي المنتج الذي توقعته.

خط الإنتاج كاملًا: من التصميم إلى الإثبات

المصنع ليس آلة واحدة. صُمّم ديوان ليدير الخط كاملًا، فيتولى كلَّ مرحلة الوكيلُ المناسب، ويُتحقَّق من كل نتيجة قبل أن تنتقل إلى ما بعدها:

  • التصميم: يقرأ الوكلاء نظام التصميم والشاشات من Figma عبر بروتوكول MCP مباشرة، فيطابق ما يبنونه ما صُمّم.
  • التخطيط: يقسّم المخطِّط العمل إلى مهام لكلٍّ منها معايير قبول ومسارات ملفات متوقعة، فلا تعمل في الوقت نفسه مهمتان ستعدّلان الملفات نفسها.
  • البناء: يعمل Claude Code و Codex و opencode و Gemini وغيرها من وكلاء سطر الأوامر في بيئات معزولة، ولكلٍّ منها أن يشغّل وكلاءه الفرعيين.
  • الطرفية: يشغّل الوكلاء أوامر البناء والسكربتات والأدوات داخل بيئاتهم المعزولة، وتتابع أنت المخرجات مباشرة دون أن تُبقي نافذة طرفية مفتوحة.
  • الاختبار: يشغّل وكيل الجودة اختبارات الوحدات والاختبارات الشاملة لمواقع الويب والتطبيقات الأصلية، ويرفق نتائجها دليلًا على كل معيار قبول.
  • الأمان: يفحص وكيل الأمان الأسرار المكشوفة وثغرات الحقن والمصادقة والاعتماديات الخطرة، وفق ممارسات OWASP للبرمجة الآمنة.
  • المراجعة والتسليم: يراجع وكيلٌ ثانٍ العمل، ويجب أن تنجح فحوص CI كلها، ثم يصلك طلب التغيير لتوافق عليه.

والحجم تحدّده حساباتك لا الأداة: لكل حساب لدى مزوّد حدٌّ خاص للجلسات المتوازية، ويُبقي الموزّع كلَّ حساب منها مشغولًا.

نظرة من الداخل

اكتمل تصميم تطبيق سطح المكتب، وهذه شاشات من ملف Figma مع بيانات تجريبية أستخدمها في الاختبار.

تجيب الصفحة الرئيسية أولًا عن سؤال «ما الذي يحتاجني؟»: طلب تغيير ينتظر الموافقة، وسؤال من وكيل، واختبار فاشل، فوق العمل الجاري.

في لوحة Agentic Scrumban تُظهر كل بطاقة وكيلها وتقدّمها وتكلفتها. وقد سُلّمت إحدى المهام من Claude إلى Codex حين بلغ حدّه.

تشغيل مباشر: سجلّ زمني لما فعله الوكيل، واختباراته، ونقطة الحفظ، ومعايير القبول تُستوفى واحدًا تلو الآخر مع وصول الأدلة.

موافقة مع أدلتها: نجاح CI وموافقة المراجع واستيفاء معايير القبول الخمسة بالأدلة، مع التغييرات والتكلفة أمامك قبل أن تقرّر.

الاستهلاك عبر كل حسابات المزوّدين: التكلفة والرموز وعمليات التسليم، وأيّ الحسابات نشط وأيّها في فترة التبريد.

اسأل ديوان: حين بلغ Claude حدّه في منتصف الإجابة، أكمل المساعد مع Codex وأخبرك بذلك.

وعلى أجهزة Mac يُبقي شريط ديوان المصنعَ أمامك دون فتح التطبيق؛ فهو يستقر أعلى الشاشة ويعرض ما يعمل الآن، وما ينتظرك، والمدى الذي بلغته كل عملية.

شريط ديوان: وكلاء قيد التشغيل الآن، وسؤال ينتظرك، وتجهيز المستودع جارٍ، واختبارات تتحقق من تغييراتك.

قواعد لا يكسرها المصنع

قبل أي شاشة أو سطر برمجي كتبتُ عشرة مبادئ، وحين يتعارض مبدأٌ مع السهولة يفوز المبدأ. خمسة منها تحدّد كل شيء تقريبًا:

الوكلاء قابلون للاستبدال، والحالة لا. الحقيقة على اللوحة وفي git وفي ملاحظة التسليم، لا داخل جلسة الوكيل. يمكن أن يتوقف وكيلٌ أو ينفد رصيده أو يُستبدل دون أن يضيع شيء من العمل.

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

لا يرفع الوكيل صلاحياته بنفسه أبدًا. يستطيع الوكيل أن يقترح تغيير سياسة، لكن التغيير نفسه إجراءٌ يسألني دائمًا.

التحقق قبل الثقة. الإنجاز يعني نجاح فحوص CI كلها، ومراجعةً من وكيل مختلف، ويُفضّل أن يكون من مزوّد مختلف، ودليلًا مرتبطًا بكل معيار قبول.

الانتباه أولًا. كل شاشة تجيب عن ثلاثة أسئلة بالترتيب: ما الذي يحتاجني، وما الذي يعمل الآن، وما الذي تغيّر منذ آخر مرة نظرت.

المعمارية: ثلاث طبقات

الواجهات تعرض وتتحكم فقط، وطبقة التحكم هي المرجع الوحيد للحالة، والمشغّلات على أجهزتك هي التي تنجز العمل.

  • الواجهات (Mac و iPhone و iPad والويب وسطر الأوامر و Telegram) لا تحمل أي منطق عمل ولا تتواصل فيما بينها، لذلك تعرض دائمًا الشيء نفسه.
  • طبقة التحكم خادم Fastify يقدّم REST وبثًّا مباشرًا عبر اتصال WebSocket دائم، مع قاعدة PostgreSQL لحفظ الحالة، ومحرّك Temporal لسير عمل يصمد أمام الأعطال. المؤقتات والموافقات وإعادة المحاولة والانتقال إلى البديل كلها تبقى بعد إعادة التشغيل.
  • المشغّلات تشغّل وكلاء البرمجة في بيئات git معزولة، وتفرض السياسات أثناء التشغيل، وتتصل بطبقة التحكم من الداخل إلى الخارج. ولا يغادرها الكود ولا مفاتيح المزوّدين.

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

كل ما يحدث يُسجَّل حدثًا في سجلٍّ لا يُعدَّل، مرقّمٍ بلا فجوات. فإذا انقطع اتصال الهاتف عاد من حيث توقف تمامًا.

يعمل ديوان على أجهزة Mac دون حاجة إلى Docker أصلًا، وعلى خادم خاص أو منزلي عبر Docker Compose أيضًا. وفي الحالتين لا يمكن الوصول إليه إلا عبر شبكة Tailscale الخاصة، بلا أي منافذ عامة.

الأمان: مالكٌ واحد لكل مصنع

  • تُفرض السياسات مرتين: في محرّك سير العمل، ثم في المشغّل عبر خطافات الوكيل والبيئة المعزولة وقوائم الأوامر المسموح بها.
  • تبقى مفاتيح المزوّدين وبيانات git في سلسلة مفاتيح نظام التشغيل على كل مشغّل، ولا تحفظ طبقة التحكم إلا البيانات الوصفية والأحداث والتغييرات اللازمة للمراجعة.
  • ما يجب أن يحفظه الخادم، مثل رموز مستضيف الكود وسرّ التحقق بخطوتين، يُشفَّر عند التخزين باستخدام AES-256-GCM قبل حفظه.
  • تُجزَّأ كلمات المرور بـ argon2id وتُقارن بقائمة كلمات مرور مسرّبة معروفة، وتُضاف إليها مفاتيح المرور ورمز تحقق اختياري بخطوتين. ولكل جهاز جلسته الخاصة التي تُقفل عند الخمول ويمكن إلغاؤها.
  • وإلى أن يكتمل تسجيل الدخول، يرفض الخادم الاستماع إلا على الجهاز المحلي.

العربية والإنجليزية منذ اليوم الأول

تضيف معظم المنتجات العربية في النهاية، ويظهر ذلك بوضوح. أما في ديوان فكل شاشة مصمَّمة بأربع نسخ: الإنجليزية بالوضعين الفاتح والداكن، والعربية بالوضعين الفاتح والداكن.

  • النصوص العربية مكتوبة بعربية فصحى طبيعية لا مترجمة حرفيًا، مع مسرد يعطي كل مفهوم اسمًا واحدًا في كل لغة.
  • يُعكس التخطيط للعربية، بينما تبقى الشيفرة والمسارات ومعرّفات المهام والتكاليف من اليسار إلى اليمين باستخدام آلية العزل في Unicode لاتجاه النص. ويفشل البناء إذا ترك نصٌّ عربي مثالًا دون عزل.
  • كل عدد في التطبيق يستخدم صيغ الجمع العربية الست.
  • خط Geist للإنجليزية و Readex Pro للعربية، من مجموعة رموز تصميم واحدة يتشاركها تطبيق الويب وتطبيقات SwiftUI الأصلية.

كيف يُبنى المصنع

يُبنى ديوان بالطريقة التي سيُستخدم بها: وكلاء الذكاء الاصطناعي ينجزون معظم العمل، تحت قواعد ومراجعات.

المواصفات أولًا. قبل أي كود كُتبت 21 وثيقة تصميم و13 سجلًّا لقرارات المعمارية، وكل شاشة وكل سطر يعود إلى إحداها.

التصميم أولًا. صُمّم منتج سطح المكتب كاملًا في Figma قبل أول إيداع: نظام تصميم و15 شاشة بكل حالاتها، وكلٌّ منها بأربع نسخ للغة والوضع. ورموز التصميم في الكود تُولَّد من Figma مباشرة.

الأدلة لا الادّعاءات. لكل مهمة فرعها الخاص وخطة مكتوبة ودليل على كل معيار قبول، ويراجعها مراجعٌ مستقل لم يرَ العمل قبل أن تصلني.

والمراجعات تكشف مشكلات حقيقية. ثلاثة أمثلة، كلها اكتُشفت قبل الدمج:

  • رسالة خطأ عربية كانت تعرض بادئة عناوين الويب مقلوبة على الشاشة.
  • خادم كان يمكن أن يقبل اتصالات من الشبكة قبل وجود تسجيل الدخول.
  • سرّ تحقق بخطوتين كان محفوظًا نصًّا صريحًا في مسودة مخطط البيانات.

مقارنة بالأدوات الأخرى

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

حُدّثت المقارنة في 8 نوفمبر 2026 ويبيّن عمود ديوان ما صُمّم ليقدّمه، فهو ما زال قيد التطوير.

أداتا Cursor و GitHub Agent HQ قويتان ومتاحتان اليوم، لكن كلًّا منهما تتمحور حول منصتها واشتراكها، ووكلاؤهما السحابيون يعملون على بنيتهما الخاصة. ولا تنقل أيٌّ منهما المهمة إلى مزوّد آخر حين يبلغ وكيلٌ حدّه.

أما Devin و Factory فوكلاء مستقلون مبنيّون للفرق والمؤسسات، ويأتي كلٌّ منهما بوكيله الخاص، بينما يشرف ديوان على الوكلاء الذين تدفع لهم أصلًا.

وأقربها إلى الفكرة Conductor و Vibe Kanban إذ يشغّلان وكلاء متوازين في بيئات git معزولة على جهازك. لكن لا يصف أيٌّ منهما طبقة سياسات أو بوابات أدلة أو تسليمًا تلقائيًا. وقد أُغلقت شركة bloop المطوِّرة لـ Vibe Kanban في شهر أبريل من عام 2026 مع استمرار المشروع مفتوح المصدر بصيانة من مجتمعه.

وأما Omnara فأداة جيدة للتحكم بالوكلاء من الهاتف، لكنها ليست مخطِّطًا ولا مشرفًا.

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

المصادر: Vibe Kanban / Conductor / Cursor / GitHub Agent HQ / Devin / Factory / Omnara

أين وصلنا

اكتمل تصميم سطح المكتب، ويُبنى الأساس الآن. دُمجت خمس مهام من المرحلة الأولى: المستودع الموحّد مع التكامل المستمر، وعقود API مشتركة تولّد أنواع TypeScript وعميل Swift معًا، ورموز التصميم المولَّدة من Figma مباشرة، وفهارس النصوص العربية والإنجليزية، والخادم بسجل أحداثه وبثّه المباشر. وتسجيل دخول المالك قيد البناء الآن.

  • المرحلة 0 — التصميم: اكتمل سطح المكتب، ويليه تصميم iPhone و iPad قريبًا.
  • المرحلة 1 — الأساس: قيد التنفيذ. التثبيت وتسجيل الدخول وبدء تشغيلات Claude Code و Codex ومتابعتها مباشرة مع الاستهلاك.
  • المرحلة 2 — المشاريع واللوحة والمساعد: التالية. التسليم التلقائي عند بلوغ الحدّ، وطلبات التغيير، ومساعد تسأله عن أي شيء.
  • المرحلة 3 — الهاتف والإشعارات: الإجابة عن الأسئلة والموافقة على العمل من iPhone و Telegram مباشرة.
  • المرحلة 4 — المشرف وبوابات الجودة: ديوان يوزّع العمل ويتحقق منه وفق سياساتك.
  • المرحلة 5 — الصقل والتوسع: سجل المهارات والميزانيات وتطبيق الويب ومزيد من الوكلاء.
  • المرحلة 6 — تطبيقات Android الأصلية: مؤجّلة حتى تكتمل المراحل السابقة.

سأشارك التقدّم هنا مع اكتمال كل مرحلة، بما في ذلك ما لا يسير كما خُطّط له.