multi-agent هو الـ buzzword الذي يلصقه الجميع على شريحة. وهو أيضًا الموضع الذي يصبح فيه Claude Code مثيرًا للاهتمام فعلًا — حين يُستعمل بدقّة جراحيّة.

الشكل الناجح: خطّ أنابيب صغير من sub-agents مُقيّدة، كلّ منها يفعل شيئًا واحدًا، مع تسليم صريح. الشكل الفاشل: "سرب من الوكلاء يتجادلون حول البنية".

لنكن تكتيكيّين.

الأنماط الثلاثة التي تشحن فعلًا

1. خطّ الأنابيب الخطّيّ (الخبز اليومي)

test-writer  →  test-fixer  →  code-reviewer  →  release-bot

كلّ خطوة لها مدخل ومخرج. الإخفاقات توقف خطّ الأنابيب. هذا 80% ممّا تستخدمه الفرق.

2. fan-out / fan-in

حين تكون المهمّة متوازية بطبيعتها — ترجمة 5 ملفات، توليد اختبارات لـ 12 وحدة، فحص logs من 8 خدمات — وزّعها.

            ┌─ translator(es) ─┐
            ├─ translator(fr) ─┤
spawner ──> ├─ translator(ar) ─┤── merger
            ├─ translator(pt) ─┤
            └─ translator(de) ─┘

تطلق N من sub-agents المتخصّصة بالتوازي، ثمّ يقوم merger sub-agent بمصالحة المخرجات (يحذف التكرار، يختار النسخة الأعلى ثقة، يكتب PR واحدة).

3. حلقة النقد

writer  ↔  critic

يُنتج الـ writer. يُقيّم الـ critic وفق rubric. يُراجع الـ writer. تتوقّف حين يُعطي الـ critic ≥ عتبة أو بعد N جولات.

يلمع هذا النمط في:

• إعادة كتابة الوثائق.
• خطط الترحيل.
• اقتراحات إعادة الهيكلة حين يكون "هل هذا نظيف؟" هو البوّابة.

يجب أن يكون الـ critic sub-agent مختلف عن الـ writer. أن ينتقد الوكيل نفسه، فمسرحيّة.

أين يتوقّف multi-agent عن دفع الفائدة

بعد سنة، إليك رأيي الصريح في تناقص العائدات:

• وكيلان: قفزة كبيرة. writer + reviewer مكسب حقيقي.
• 3-4 وكلاء: مفيد لخطوط أنابيب واضحة (test-writer → fixer → reviewer).
• 5+ وكلاء: هامشي في أحسن الأحوال. كلفة التنسيق > مكسب التفويض.
• "سرب من 10 وكلاء يتجادلون": عرض، لا workflow.

إن كان خطّ أنابيبك يضمّ أكثر من 4 sub-agents، اسأل نفسك إن كان نصفهم يمكن أن يكون أوامر shell عاديّة أو أهداف Makefile.

ملموس: خطّ أنابيب "PR factory"

الهدف: أخذ تذكرة Linear، شحن PR.

1. ticket-reader     → يحلّل تذكرة Linear، يخرج prompt /feature
2. implementer       → يكتب الكود
3. test-writer       → يكتب / يحدّث الاختبارات
4. test-fixer        → إن فشل اختبار، أصلح الكود (لا الاختبار)
5. code-reviewer     → يراجع الـ diff، إمّا SHIP / FIX-FIRST / REWRITE
6. release-bot       → يصوغ وصف PR + مدخلة changelog
7. (إنسان)           → يراجع الـ diff ويدفع

كلّ خطوة هي sub-agent في .claude/agents/. الخطوة البشريّة في النهاية غير قابلة للتفاوض — هناك يحدث git push.

زمن التنفيذ على ميزة نموذجيّة: 4 إلى 12 دقيقة wall clock. مراجعة بشريّة في النهاية: 5 إلى 15 دقيقة. من النهاية إلى النهاية: ميزة في الساعة، مستدامة.

كيف تستدعي خطّ أنابيب فعلًا

نوعان.

تشغيل يدويّ خطوة بخطوة (موصى به في البداية)

> /agents implementer
> الهدف: ... القيود: ... DoD: ... الملفات: ...

# انتظر، راجع

> /agents test-writer
> اكتب اختبارات للكود الجديد.

# انتظر، راجع

> /agents code-reviewer
> راجع الـ diff.

تبقى أنت في القيادة. بطيء لكن آمن.

منسّق عبر slash command

.claude/commands/pr-factory.md:

1. أطلق `implementer` بالهدف المُقدَّم من المستخدم.
2. انتظر الانتهاء. إن فشل implementer، أجهض.
3. أطلق `test-writer` على الـ diff.
4. أطلق `test-fixer` حتى تنجح الاختبارات أو تبلغ 3 محاولات.
5. أطلق `code-reviewer` على الـ diff النهائي.
6. إن كان الحكم != SHIP، أبلِغ المستخدم وتوقّف.
7. وإلّا أطلق `release-bot` لوصف الـ PR.
8. اطبع ملخّصًا من سطر واحد وتوقّف. لا تدفع أبدًا.

ثمّ:

> /pr-factory
> الهدف: <املأ> القيود: <املأ> DoD: <املأ> الملفات: <املأ>

تضغط أمرًا واحدًا. خطّ الأنابيب يعمل. الـ push يبقى ضغطة بشريّة.

أنماط متوازية — متى تستخدمها

شغّل الوكلاء بالتوازي حين:

• العمل مستقلّ (ترجمة 5 ملفات، تلخيص 8 PRs).
• يمكنك كتابة merger حتميّ (concat، dedup، pick-highest-score).
• يمكنك تحديد ميزانية الكلفة (التوازي = استدعاءات API أكثر، wall clock أسرع).

تجنّب التوازي حين:

• للمهامّ اعتماديات (test-fixer يحتاج diff implementer).
• خطوة الدمج ضبابيّة ("أيّ بنية نُفضّل؟"). هذا ليس دمجًا — بل قرار بشريّ.

الحيلة الأكثر فائدة: تسليمات صريحة

تنهي كلّ sub-agent دورها بإصدار تسليم منظّم:

status: ok | needs-human | failed
artifacts:
  - path: src/cache.ts
  - path: tests/cache.test.ts
notes: "تنفيذ LRU + TTL. كلّ الاختبارات خضراء."
next: test-writer | code-reviewer | done

يقرأ الوكيل التالي هذا التسليم ويعرف بالضبط أين هو. لا اشتقاق مجدّد للسياق، لا "مهلًا، ما الهدف مجدّدًا؟"

توحيد التسليم هو الفعل الأعلى رافعة عند امتلاك 3+ sub-agents. هو المكافئ لـ multi-agent لتوقيع دالّة مُحكمة الأنواع.

---

المقال التالي: بناء ميزات كاملة — أخذ كلّ ما في هذا المقال والمقالات 3-7، وعرض جلسة فعليّة من تذكرة إلى PR، أمرًا تلو الآخر.