سياق المنتج لوكلاء البرمجة بالذكاء الاصطناعي: ماذا تشارك وكيف
يستطيع وكلاء البرمجة قراءة شيفرتك، لكنهم لا يقرؤون عملاءك. إليك سياق المنتج الذي يحتاجونه، والأدوات التي توصله، وكم منه يكفي، مع task packet جاهز للنسخ.
سياق المنتج لوكلاء البرمجة بالذكاء الاصطناعي هو المجموعة الصغيرة والحديثة من الحقائق التي يحتاجها الوكيل ولا تظهرها الشيفرة: من صاحب المشكلة، والأدلة، والقرار الحالي ومسؤوله، والقيود، وكيف سيتحقق شخص من النتيجة. أفضل إعداد له ثلاث طبقات: ملف تعليمات قصير في المستودع، وtask packet لكل تغيير، ورابط مباشر إلى مصدر الحقيقة الخاص بمنتجك.
أهم النقاط
المزيد من السياق لا يعني سياقاً أفضل. اختبرت Chroma 18 نموذجاً ووجدت أن الأداء «يصبح أقل موثوقية بشكل متزايد مع زيادة طول المدخلات»، حتى في المهام البسيطة (Chroma, 2025).
تعريف Anthropic نفسها لهذه المهمة هو إيجاد أصغر مجموعة من الرموز (tokens) عالية الإشارة للمهمة، وتحميل الباقي عند الحاجة عبر الروابط ومسارات الملفات (Anthropic, 2025).
ملفات المستودع مخصصة للقواعد الدائمة. تستهدف Anthropic أقل من 200 سطر لكل ملف CLAUDE.md، وتقول Cursor إن القواعد يجب أن تبقى دون 500 سطر، لذا فأدلة العملاء والقرارات المتغيرة لا مكان لها هناك.
لا توجد أداة واحدة هي الأفضل. استخدم ملف تعليمات قصيراً، وtask packet واحداً لكل تغيير، واتصال MCP بالمكان الذي تُحفظ فيه القرارات فعلاً.
الفرق تخسر بالفعل أكثر من 25% من أسبوع عملها في البحث عن المعلومات (Atlassian, 2025). وويكي منتج ثانٍ يُكتب للوكلاء وحدهم يزيد الأمر سوءاً.
ما الذي يُعدّ سياق منتج لوكيل برمجة بالذكاء الاصطناعي؟
يستطيع وكيل البرمجة قراءة مستودعك وتشغيل اختباراتك والبحث في ملفاتك. لكنه لا يستطيع قراءة مكالمة العميل التي بدأ بها الطلب، ولا التسوية التي اتفق عليها الفريق في اجتماع الثلاثاء، ولا سبب إبقاء ميزة ما خارج النطاق عن قصد. هذا هو سياق المنتج: «من» و«لماذا» وراء تغيير الشيفرة.
أصبح الوكلاء منتشرين بما يكفي لتصبح هذه الفجوة مهمة. ففي استطلاع Stack Overflow لعام 2025، كان 14.1% من المطورين يستخدمون وكلاء الذكاء الاصطناعي يومياً في العمل، وكان 86.9% قلقين من دقة المعلومات التي يقدمها الوكلاء (Stack Overflow, 2025). بعض هذا الخطأ سببه النموذج، وبعضه سببه طلب أغفل حقائق المنتج المهمة.
ما أفضل أداة لإعطاء وكلاء البرمجة بالذكاء الاصطناعي سياق المنتج؟
لا توجد أداة واحدة تغطي كل شيء. كل طريقة لتوصيل السياق جيدة في طبقة وضعيفة في غيرها، لذا فالسؤال المفيد هو أي مزيج يناسب المكان الذي يحفظ فيه فريقك قراراته.
بروتوكول سياق النموذج (MCP)، الذي أصدرته Anthropic معياراً مفتوحاً في 25 نوفمبر 2024، هو ما يجعل الصفوف «المباشرة» ممكنة: بروتوكول واحد بدلاً من موصّل مخصص لكل مصدر بيانات (Anthropic, 2024). فمثلاً تستضيف Linear خادماً يعمل مع Claude Code وCursor وCodex وVS Code عبر OAuth 2.1 (Linear docs).
إعداد افتراضي عملي لفريق صغير:
ملف AGENTS.md أو CLAUDE.md قصير فيه الأوامر والاصطلاحات وقواعد الأمان وسطر واحد يقول أين تُحفظ قرارات المنتج.
task packet (القالب أدناه) مرتبط بكل مهمة يتناولها الوكيل.
اتصال MCP للقراءة فقط بالنظام الذي يحتفظ بقراراتك وأدلتك، ليجلب الوكيل التفاصيل عند الطلب بدلاً من أن تلصقها أنت.
فضّل الوصول للقراءة فقط لوكلاء البرمجة ما لم تتطلب المهمة الكتابة. تقدم Linear نقطة وصول منفصلة للقراءة فقط لهذا الغرض تحديداً. وهذا مهم: 81.4% من المطورين في استطلاع Stack Overflow لديهم مخاوف أمنية وخصوصية بشأن البيانات عند استخدام وكلاء الذكاء الاصطناعي.
كم من السياق ينبغي أن تعطي وكيل البرمجة؟
أقل مما تظن، ومختاراً بعناية. ثلاثة خطوط بحثية تشير في الاتجاه نفسه.
المدخلات الطويلة تُضعف الأداء. أجرت دراسة Chroma لعام 2025 ما مجموعه 194,480 استدعاءً على 18 نموذجاً من Anthropic وOpenAI وGoogle وAlibaba. انخفض الأداء مع زيادة طول المدخلات في كل تجربة، وزادت المقاطع «المشتِّتة» ذات الصلة الموضوعية من انخفاض الدقة. وفي LongMemEval، وهو اختبار معياري لذاكرة المحادثة، سجّل كل نموذج درجات أعلى بكثير مع prompt مركّز بنحو 300 token مقارنةً بالـ prompt الكامل بنحو 113,000 token (Chroma, 2025).
الموضع مهم. في دراسة «Lost in the Middle»، استفادت النماذج من المعلومات على أفضل وجه حين كانت في بداية المدخل الطويل أو نهايته، وبشكل أسوأ بوضوح حين كانت في المنتصف (Liu et al., TACL). قد يضيع القيد الوحيد المهم داخل تصدير طويل.
الانتباه ميزانية. تصف Anthropic ظاهرة context rot بأنها تراجع قدرة النموذج على استدعاء المعلومات كلما امتلأت النافذة، لأن كل token ينتبه إلى كل token آخر، فتنشأ n² علاقة لكل n من الـ tokens. ونصيحتها أن تحتفظ بمعرّفات خفيفة مثل مسارات الملفات والروابط وتحمّل المحتوى حين يحتاجه الوكيل (Anthropic, 2025).
وتقول وثائق الأدوات الشيء نفسه بكلمات أبسط. تشير VS Code إلى أن المراجع الصريحة تُحتسب ضمن نافذة السياق، وتوصي بإضافة المصادر التي تفيد المهمة الحالية فقط (VS Code docs).
قاعدة القرار: أدرج المصدر إن كان قادراً على تغيير التنفيذ أو قرار القبول. مذكرة قرار حديثة مع مثالين تمثيليين من العملاء أفضل من تصدير كامل للـ backlog. وكل ما عدا ذلك اربطه برابط.
كيف تفصل سياق المنتج عن تعليمات المستودع؟
أبقِ ثلاثة أنواع من السياق منفصلة، لكل منها مكانه ومسؤوله.
إرشادات هندسية ثابتة: كيف تُشغَّل التطبيق، والاصطلاحات، وحدود البنية، وأوامر الاختبار، وقواعد الأمان. تقول Anthropic إن Claude يتعامل مع CLAUDE.md بوصفه سياقاً لا إعداداً مفروضاً، وإن الملفات الأطول تقلل الالتزام (Claude Code docs). وتفيد الملفات المتداخلة في قواعد الشيفرة الكبيرة: ففي AGENTS.md يتغلّب الملف الأقرب إلى الشيفرة المعدَّلة، وكان في مستودع OpenAI الرئيسي 88 ملفاً منها حين كُتب موقع agents.md (agents.md). ليس شيء من هذا مكاناً لخارطة الطريق أو لأبحاث العملاء.
3. الـ task packet
الجسر القصير بين نية المنتج وجلسة برمجة واحدة. يشير إلى القرارات ذات الصلة ويقول ما الذي ينبغي أن يفعله هذا التغيير. يمكن أن يعيش في مهمة أو موجز أو prompt، ما دام المسؤولون قادرين على إيجاده. وللحصول على نسخة كاملة مع فحوصات القبول وقواعد التوقف، استخدم قالب PRD لوكلاء البرمجة بالذكاء الاصطناعي.
يمنح هذا الفصل الوكيل ما يكفي ليتصرف، بينما تبقى معرفة الفريق الدائمة بالمنتج حيث يمكن للناس مناقشتها وتحديثها.
كيف تعطي وكيل البرمجة سياق المنتج خطوة بخطوة؟
ابدأ بمشكلة مستخدم واحدة. اذكر من المتأثر وماذا يحاول أن يفعل. اربط المقابلة أو أمثلة الدعم أو التحليلات الداعمة لها. صنّف الافتراضات على أنها افتراضات؛ فالتفسير المقنع الذي كتبه الذكاء الاصطناعي ليس دليلاً من العميل. وإن لم تكن لديك أدلة بعد، فإن سير عمل اكتشاف العملاء لمهندسي المنتج هو الطريق السريع للحصول على بعضها.
اربط القرار، لا كومة من المستندات. اختر المصدرين أو الثلاثة التي قد تغيّر التنفيذ. إذا تعارضت المصادر، فاذكر أيها الحالي، وأحل التعارضات الجوهرية إلى شخص.
اذكر النتيجة والحدود. صِف النتيجة التي يراها المستخدم، ثم الحدود: الصلاحيات، والتعامل مع البيانات، وسير العمل الحالي، وإمكانية الوصول، والأداء، وما يبقى خارج النطاق. وضع علامة «مفتوح» على القرارات المفتوحة.
اجعل الـ packet سهل التحقق. اذكر ما ينبغي أن يلاحظه المراجع. استبدل «يعمل جيداً» بسلوك يستطيع أحدهم فحصه.
اطلب من الوكيل الإبلاغ عن عدم اليقين. ليُظهر السياق الناقص والتعليمات المتعارضة والافتراضات قبل أي اختيار مؤثر. في تغيير قابل للتراجع وقليل الأثر، قد يكون المضي على افتراض موسوم أمراً مقبولاً. أما في التحكم بالوصول أو الفوترة أو البيانات الخاصة أو الإجراءات المدمّرة، فيعود أي غموض إلى إنسان.
راجع، ثم أعِد القرارات الجديدة إلى المصدر المشترك. مخرجات الوكيل مقترح. يقارنها شخص بنية المنتج باستخدام قائمة قبول مدير المنتج لمخرجات وكلاء الذكاء الاصطناعي، ويُدوَّن أي قرار جديد في سجل المنتج، لا في نص محادثة أو تعليق شيفرة فقط.
مثال: context packet للمرشحات المحفوظة
هذا سيناريو توضيحي، وليس قصة عميل ولا نتيجة بحث.
يطلب مؤسس تقني من وكيل برمجة بالذكاء الاصطناعي إضافة مرشحات محفوظة إلى لوحة معلومات داخلية. عبارة «أضِف مرشحات محفوظة» تترك خيارات المنتج مفتوحة: من يحتاجها، وهل العروض خاصة أم مشتركة، وماذا يحدث حين تتغير البيانات، وكيف يجد المستخدم عرضاً محفوظاً لاحقاً.
يقول الـ task packet:
المستخدم والمشكلة: أحد أعضاء الفريق يعيد بناء العرض المفلتر نفسه قبل كل مراجعة أسبوعية، وفي هذه الحالة الافتراضية يستغرق ذلك نحو 10 دقائق كل مرة.
الأدلة: رابط إلى ملاحظة المقابلة أو سير العمل الذي رُصد. إن لم يوجد، يقول الـ packet «افتراض».
النتيجة المرغوبة: يستطيع المستخدم حفظ عرض باسم، وإعادة فتحه، ورؤية آخر وقت حُدّثت فيه بياناته.
القيود: عدم تغيير تعريفات التقارير؛ إبقاء العروض المحفوظة خاصة افتراضياً؛ احترام صلاحيات مساحة العمل الحالية.
فحوصات القبول: حفظ عرض وإعادة فتحه؛ إعادة تسميته وحذفه؛ التعامل مع نتيجة فارغة؛ إظهار حالة واضحة بعد سحب الوصول؛ عناصر تحكم قابلة للاستخدام بلوحة المفاتيح.
القرار المفتوح: هل يجوز مشاركة العرض المحفوظ مع مساحة العمل؟ يقرر مسؤول مسمّى قبل أن يبني الوكيل المشاركة.
خارج النطاق: منشئ لوحات معلومات جديد أو نموذج تقارير أُعيد تصميمه.
صار لدى الوكيل الآن نتيجة وحدود، لكنه ما زال يختار التنفيذ. وسؤال المشاركة ظاهر قبل أن توجد الشيفرة، بدلاً من أن يُخمَّن بصمت. وبعد البناء يفحص المراجع السلوكيات الخمسة نفسها ويسجل قرار المشاركة في مصدر الفريق المشترك.
قالب context packet للنسخ
## Context packet: [feature]
- User and problem: [who needs what; what they do today]
- Evidence: [links to specific observations or data] (observed / inferred / assumed)
- Desired outcome: [the change a user should notice]
- Current decision: [the choice] (owner: [name], date: [YYYY-MM-DD], link: [record])
- Constraints: [security, permissions, data, accessibility, compatibility, performance]
- Acceptance checks: [observable behaviours, incl. empty, loading and error states]
- Open questions: [what is unknown] -> [who answers]
- Out of scope: [adjacent work to leave alone]
- Sources as of: [date or version]
- Review owner: [person who accepts the result and updates the record]
اجعله متناسباً مع المهمة. قد يحتاج نموذج أولي من شاشة واحدة إلى أربع نقاط. أما تغيير في الوصول إلى بيانات حساسة فيحتاج كل سطر ومراجعاً مسمّى.
كيف تمنع سياق الوكيل من أن يصبح قديماً؟
السياق القديم أسوأ من السياق الناقص، لأن الوكيل يتبعه بثقة. خمس عادات تُبقيه حديثاً:
نسخة مرجعية واحدة لكل حقيقة. إذا ظهرت قاعدة منتج في عدة ملفات، فحدّد أيها المرجع واربط به من الباقي. وتذكر وثائق Cursor السبب: النسخ تتقادم، فأشِر إلى الملفات (Cursor docs).
أرّخ كل packet. عبارة «المصادر حتى 12 نوفمبر» تخبر المراجع إن كان القرار قد تغيّر منذ ذلك.
عيّن لكل ملف مسؤولاً. ملف تعليمات بلا مسؤول يتضخم إلى أن لا يثق به أحد.
قلّم بعد الأخطاء، لا قبلها. أضِف قاعدة حين يكرر الوكيل الخطأ نفسه؛ واحذف القواعد التي يلتزم بها أصلاً من الشيفرة.
أغلق الحلقة بعد المراجعة. القرارات المتخذة أثناء التنفيذ تعود إلى سجل القرارات في اليوم نفسه.
فحص سريع لجودة السياق
قبل تسليم العمل، اسأل:
هل يستطيع زميل إيجاد الأدلة وراء الطلب؟
هل يمكن تمييز القرار الحالي عن اقتراح قديم؟
هل يعرف الوكيل النتيجة المقصودة للمستخدم؟
هل القيود والأهداف المستبعدة صريحة؟
هل يستطيع المراجع فحص النتيجة دون إعادة بناء المحادثة؟
هل هناك شخص مسمّى لخيارات المنتج غير المحسومة؟
إذا كانت إجابتان أو أكثر «لا»، فأصلح الـ packet أو احسم القرار قبل أن يبني الوكيل.
أخطاء شائعة عند إعطاء الوكلاء سياق المنتج
إفراغ الـ backlog كله. التصدير الكامل يدفن القرار الوحيد المهم ويكلّف سياقاً في كل دورة.
كتابة ويكي ثانٍ للوكيل. ينحرف عن الويكي الحقيقي خلال أسابيع ولا يملكه أحد.
وضع القرارات المتغيرة في CLAUDE.md أو AGENTS.md. هذه الملفات تُحمَّل مع كل مهمة؛ خصّصها للقواعد الدائمة.
اعتبار ملف اسمه «context» حديثاً. مجاورته للشيفرة لا تجعله صحيحاً. تحقق من التاريخ.
منح صلاحية الكتابة افتراضياً. ابدأ بالقراءة فقط ووسّع الصلاحية فقط حين تتطلب مهمة ذلك.
ترك القرارات في المحادثة. إذا كان السجل الوحيد لقرار ما نص محادثة، فلن يجده الوكيل التالي ولا الزميل التالي.
أين يندرج Specky
يحتفظ Specky بمكالمات العملاء والملاحظات والتذاكر والقرارات في Product Graph واحد، فتكون الأدلة وراء القرار مرتبطة لا منسوخة. ويتيح خادم MCP الخاص به لـ Claude Code وCursor وCodex وعملاء MCP الآخرين جلب هذا السياق عند الطلب: يحمّل get_product_context مبادئ المنتج المؤكدة وتعليمات مساحة العمل، ويعيد get_coding_brief ملفات PRD والقرارات والأدلة ذات الصلة بتذكرة ما. وكل ما يكتبه الوكيل يصل مسودةً لمراجعة بشرية. الإعداد موجود في صفحة MCP لوكلاء الذكاء الاصطناعي، ويغطي دليل مديري المنتج التقنيين سير العمل الأوسع.
الأسئلة الشائعة
ما سياق المنتج لوكيل برمجة بالذكاء الاصطناعي؟
هو المعلومات التي يحتاجها الوكيل ولا تظهرها الشيفرة: من صاحب المشكلة، والأدلة وراءها، والقرار الحالي ومسؤوله، والقيود، والأهداف المستبعدة، والفحوصات التي سيجريها المراجع. أما سياق الشيفرة، مثل بنية الملفات وأوامر الاختبار، فيستطيع الوكيل عادةً إيجاده بنفسه. وسياق المنتج على أحدهم أن يزوّده.
ما أفضل أداة لإعطاء وكلاء البرمجة بالذكاء الاصطناعي سياق المنتج؟
لا توجد أداة واحدة تفعل كل شيء. استخدم ملفاً قصيراً في المستودع (CLAUDE.md أو AGENTS.md أو قواعد Cursor) للقواعد الدائمة، وtask packet أو PRD لكل تغيير، واتصال MCP بالمكان الذي تعيش فيه قراراتك وأدلتك، مثل متتبع المهام أو أداة المستندات أو مساحة عمل لأدلة المنتج. اختر بحسب المكان الذي يسجل فيه فريقك قراراته فعلاً.
هل يوضع سياق المنتج في CLAUDE.md أو AGENTS.md؟
مجرد مؤشر إليه فقط. هذه الملفات تُحمَّل مع كل مهمة وتعمل أفضل حين تكون قصيرة: تستهدف Anthropic أقل من 200 سطر لكل CLAUDE.md. ضع فيها الأوامر والاصطلاحات وقواعد الأمان، مع سطر يقول أين تُحفظ قرارات المنتج. وأبقِ أدلة العملاء والقرارات المتغيرة في مكانها المشترك واربط بها من كل مهمة.
كم من السياق ينبغي أن أعطي وكيل البرمجة؟
ما يكفي لتغيير التنفيذ أو قرار القبول، وليس أكثر. تُظهر دراسة Chroma عن context rot وورقة «Lost in the Middle» أن النماذج تصبح أقل موثوقية كلما طالت المدخلات وأنها تفوّت المعلومات المدفونة في المنتصف. وعملياً، تتفوق عادةً مذكرة قرار واحدة ومثالان أو ثلاثة تمثيلية وفحوصات قبول واضحة على تصدير كامل للمستندات.
هل يستطيع وكيل برمجة بالذكاء الاصطناعي قراءة Jira أو Linear أو Notion مباشرة؟
نعم، عبر خوادم MCP. تستضيف Linear خادماً يعمل مع Claude Code وCursor وCodex وVS Code، ويتيح خادم Notion للمساعد البحث في الصفحات وقواعد البيانات. ابدأ بالوصول للقراءة فقط، وتذكّر أن التذاكر وصفحات الويكي نادراً ما تقول أي قرار هو الحالي أو أي أدلة تدعمه. وهذا ما زال يحتاج إلى task packet.
GDPR-aligned. EU workspace data is stored in Frankfurt, Germany. GDPR and EU data Built in Vienna, Austria. A product of influence solutions fm GmbH (FN 675374y). Imprint 14-day trial. Card required, and nothing is charged until day 14. 30-day refund after subscribing. See pricing