الوكلاء الفرعيون في بناء موقع: فوّض القياس واحتفظ بالقرار

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

ما الوكيل الفرعي فعلاً

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

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

الرابعة أدقّها وأعلاها قيمة. فالوكيل الذي استدللت معه ساعة يميل إلى موافقتك، لأن فرضيّتك في سياقه. أمّا تسليم الـdiff لقارئ جديد بلا تاريخ فيمنحك قراءة غير مرتهنة، وهي النوع الوحيد الذي يستحقّ في مراجعة. والحيلة أن تعطيه الكود لا استنتاجك.

المهمّة التي لا يجوز تفويضها قطّ

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

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

تقييد الأدوات هو المقصد لا أثر جانبي

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

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

التسليم هو كلّ الخطر

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

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

التوازي ليس مجّانياً

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

كيف قسّمنا موقعاً من 210 صفحة

هذا الموقع فيه 210 صفحة جغرافية، والأجزاء الوحيدة من ذلك العمل التي فُوِّضت كانت القياس: إيجاد الصفحات التي تشترك في زاوية، وحساب التشابه بين كل زوج، وسرد ما لا روابط داخلة إليه. وكلّه عاد بأرقام. أما الكتابة وتوزيع الزوايا والقرارات في أيّ التصادمات يهمّ، فبقيت في نافذة واحدة، لأن كل واحد منها اعتمد على ما تقوله الصفحات الـ209 الأخرى. هذا القسم هو كامل المنهج، ودليل البناء يغطّي بقيّته. وإن فضّلت تسليم الأمر كلّه، فهذا ما نفعله.

ملاحظتان على النطاق قبل التوسّع في هذا. الوكلاء الفرعيون يعملون داخل جلسة واحدة، والتوثيق يفصلهم عن الترتيبات الأخرى التي تشبههم: الوكلاء في الخلفية لجلسات مستقلّة كثيرة تُراقَب من مكان واحد، وفِرق الوكلاء لمجموعة مُشرَف عليها. واختيار الخطأ من هذه الثلاثة أشهر طريق يصير به هذا مكلفاً. والتعليمات التي يبدأ بها الوكيل المفوّض هي تعليمات مشروعك، وهذا يجعل مقال CLAUDE.md أرخص رافعة على جودة العمل المفوّض.