Maggy، الـ harness مفتوح المصدر لهندسة الذكاء الاصطناعي من palgu>.
من الفريق المطور لـ palgu>: نقدم Maggy، وهو harness مفتوح المصدر يحوّل Claude Code وCodex وKimi وGemini CLI إلى مسار عمل محكوم بالاختبارات وبوابات الجودة، مع توجيه واعٍ بالتكلفة عبر 13 فئة من النماذج، وذاكرة عابرة للجلسات، ونظام إضافات. شغّله محليًا، وامتلك كل سطر فيه. ووجّهه إلى palgu> عندما يحتاج فريقك إلى بوابة محكومة.
- شغّل التوجيه متعدد النماذج الخاص بك محلياً، بمفاتيحك الخاصة، مع اختيار النموذج الأقل تكلفة والأكفأ لكل مهمة.
- أضف harness هندسيا حقيقيا إلى سطر الأوامر لديك: TDD، وبوابات تحقق، وذاكرة، وفرق وكلاء.
- استضفه بنفسك وامتلكه بالكامل من البداية إلى النهاية، مفتوح المصدر، بلا حساب ولا بوابة مطلوبة.
جزآن، مستودع واحد
ابدأ مع Bootstrap في 30 ثانية؛ وأضف خادم Maggy عندما تحتاج إلى التوجيه، البروتوكولات، ولوحة التحكم.
حزمة إعدادات قابلة للتثبيت (67 مهارة، وخطافات، وقواعد، وقوالب) توضع في ~/.claude/ وتطبق في جلستك التالية. يستغرق التثبيت نحو 30 ثانية، ويعمل مع Claude Code وCodex وKimi وGemini CLI.
خادم FastAPI محلي اختياري مع لوحة تحكم ويب يضيف توجيها من 13 مستوى، وبروتوكولات المهارات، ومخطط كود Cortex عبر MCP، وعزل Polyphony، والإضافات. maggy serve → localhost:8080
الأنظمة الأساسية
كل ما تضيفه Maggy، في مكان واحد.
تُوجَّه كل مهمة إلى أرخص نموذج قادر فعليًا على إنجازها.
- تُقيَّم كل رسالة من 1 إلى 10 من حيث التعقيد والمخاطر ("درجة الأثر") وتُصنَّف حسب نوع المهمة، كل ذلك محليًا عبر مصنّف Qwen3 مجاني، لذا لا يكلّف الفرز شيئًا.
- تحدد النتيجة الفئة المناسبة: T0 Qwen3 (محلي) للتصنيف والعمليات المجمعة، صعوداً عبر DeepSeek و Kimi و Gemini و Grok و Codex، وصولاً إلى Claude Sonnet/Opus (من T11 إلى T12) لمراجعة البنية المعمارية والأمان. يستقر نحو 80% من العمل الفعلي في الفئات المتوسطة القوية ومنخفضة التكلفة.
- سقف ميزانية مع خفض تلقائي للمستوى: عندما تقترب المؤسسة من الحد الأقصى، ينتقل التوجيه إلى مستويات أقل تكلفة بدلا من الحظر. كما أنه مدرك للإجهاد ومتسلسل، فإذا فشل استدعاء يتراجع تلقائيا عبر السلسلة.
مسارات عمل حتمية متوافقة مع المقصد، وليست مجرد أوامر نصية.
- البروتوكولات هي ملفات YAML (maggy/skills/protocols/). عندما يتطابق هدفك مع أحدها ("الدفع إلى git"، "إطلاق ميزة")، ينفذ Maggy الخطوات بالترتيب مع بوابات تحقق فعلية.
- مثال، git-push: فحص الكود (lint)، التحقق من الأنواع (typecheck)، الاختبارات، التجهيز (stage)، الاعتماد (commit) (برسالة يكتبها الذكاء الاصطناعي)، ثم الدفع (push). أي خطوة تفشل توقف البروتوكول؛ فلا يُشحن شيء نصف مكتمل.
- أفلت ملف .yaml لإضافة مهاراتك الخاصة. تغطي 67 مهارة مدمجة كلاً من Python وTypeScript وReact وReact Native وFlutter وSupabase وStripe وPlaywright والأمان وسجلات القرارات المعمارية (ADRs) والتفويض بين الوكلاء.
الاختبارات تخبرك بأن الكود قد اجتاز؛ أما Telos فيخبرك بأنه حقق مقصده.
- يقيّم Telos العمل وفق مقياس الإخلاص للمقصد (Intent Fidelity Scale): IFS = F1 x F2 x F3 عبر ثلاثة مستويات، المطابقة (هل يفي بالمواصفات المكتوبة)، والتحقق (هل يفعل الشيء الصحيح)، والسلامة (هل هو سليم وآمن).
- النتيجة تراكمية بالضرب: الحصول على صفر في أي مستوى منفرد يهبط بالمجموع الكلي إلى الصفر. لا يمكنك الاجتياز بالتفوق في مستويين وتجاهل الثالث.
- يأتي كإضافة، لذا يعمل كجزء من خط الأنابيب بدلاً من كونه خطوة يدوية لاحقة.
مخطط كود قابل للاستعلام يمكن لأي harness استخدامه عبر MCP.
- يبني Cortex رسمًا بيانيًا لخصائص الكود يضم 10 أنواع من الحواف، ومقاييس التعقيد الحلقي (cyclomatic complexity)، وبحثًا نصيًا كاملاً عبر FTS5، واجتيازًا ثنائي الاتجاه، كل ذلك في قاعدة بيانات SQLite واحدة.
- يتيح 15 أداة MCP، ليتمكن Claude Code أو Codex أو أي عميل MCP من طرح أسئلة مهيكلة ("ما الذي يستدعي هذا؟"، "ما الذي سيعطّله هذا التغيير؟") بدلاً من البحث النصي عبر grep.
- أثبت تفوقه في اختبارات الأداء مقارنة بأساليب ذاكرة الكود التقليدية: اجتياز المخطط يتفوق على RAG المسطح في أسئلة "لماذا" و"نطاق التأثير".
شغّل عدة وكلاء على مستودع واحد دون تعارض في الملفات.
- تحصل كل جلسة وكيل متزامنة على مساحة عمل معزولة عبر Docker، تجهز تلقائيا عند بدء جلسة ثانية.
- لأن كل وكيل يعمل في نسخة معزولة خاصة به، لا يتسبب العمل المتوازي أبدا في إتلاف ملفات وكيل آخر، وهو نمط الفشل المعتاد عند تشغيل عدة وكلاء على مستودع مشترك.
- تتيح لك أوضاع العزل اختيار مدى صرامة الفصل لكل عملية تشغيل.
ذاكرة تدوم بعد ضغط السياق وتستمر عبر الأسابيع.
- Mnemos هي ذاكرة محددة بنطاق المهمة مع نموذج إجهاد رباعي الأبعاد ونقاط حفظ مصنّفة. تستوعب سجلات جلسات Claude Code، وتقيّم مدى "ضبابية" كل جلسة، وتنشئ نقاط حفظ تلقائية قبل ضياع السياق.
- عندما يُضغط السياق، يستعيد Mnemos نقطة الحفظ المصنفة بدلاً من إجبارك على إعادة شرح المهمة، مما يوفر الرموز (tokens) مع الحفاظ على تسلسل العمل.
- Engram هي الطبقة طويلة الأمد: تحفظ المعرفة المعمارية عبر الأسابيع وتعالج سبعة أنواع متمايزة من "فقدان الذاكرة" حتى لا تتبخر القرارات بين الجلسات.
يخزن سبب وجود الكود، وليس ماهيته فحسب.
- يسجل مخطط خصائص الكود المعزز بالمقصد (Code Property Graph) المنطق الكامن وراء الكود، وعقد الأسباب (ReasonNodes) والقيود، إلى جانب البنية الهيكلية.
- يرصد الانحراف عبر ستة أبعاد، وينبّه عندما يبتعد التنفيذ عن المقصد المعلن.
- كما يمنع تكرار التنفيذ: فقبل بناء أي شيء جديد، يخبرك المخطط إن كان موجودا بالفعل.
خط أنابيب TDD من ستة وكلاء بآلية إلزام صارمة لا تعتمد على التذكر.
- ستة أدوار تدير كل ميزة: القيادة، الجودة، الأمان، المراجعة، الدمج، والميزة؛ خط أنابيب حقيقي، وليس نموذجاً واحداً يفعل كل شيء.
- خطافات الإيقاف تفرض التطوير القائم على الاختبار (TDD): يجب أن تنجح الاختبارات قبل اعتبار المهمة منجزة. لا نجاح للاختبار، لا دمج.
- تُفرض بوابات الجودة على كل ملف: بحد أقصى 20 سطراً لكل دالة، و3 معاملات، ومستويين من التداخل، كما تتطلب التغييرات غير البسيطة سجل قرارات معمارية ADR (يُستنتج عكسياً من سجل git إذا كان مفقوداً).
التوجيه: 13 طبقة، النموذج الأقل تكلفة والأكثر كفاءة يفوز
تُقيَّم كل رسالة من 1 إلى 10 من حيث التعقيد وتُصنَّف حسب نوع المهمة (محليًا عبر Qwen3). تظل الطلبات البسيطة مجانية ومحلية، بينما ترتقي المهام المعمارية الصعبة إلى Claude. كل ذلك بسقف للميزانية وخفض تلقائي لمستوى النموذج.
| T0 | Qwen3 (محلي) | التصنيف، والفرز، والعمليات المجانية بالجملة |
| T1 | Gemini Flash-Lite | الاستخراج بالجملة، وخطوط الأنابيب |
| T2 | DeepSeek Flash | التوثيق، والاختبارات، وبناء الهياكل الأولية |
| T3 | Gemini Flash | متعدد الوسائط، رؤية، صوت |
| T4 | DeepSeek Pro | البرمجة المعقدة، وإعادة هيكلة الكود |
| T5 | Gemini CLI | برمجة وكيلية عبر ملفات متعددة |
| T6 | AGY | متكامل من البداية إلى النهاية (git + كود + اختبار) |
| T7 | Kimi | تحليل السياقات الطويلة |
| T8 | Gemini Pro Search | بحث معمّق، سياق بحجم 2M |
| T9 | Grok | تحليل المنافسين، والاستدلال |
| T10 | Codex | التوليد بالجملة، والمهام الحساسة أمنيا |
| T11 | Claude Sonnet | كود حساس للجودة، وتصحيح الأخطاء |
| T12 | Claude Opus | البنية المعمارية، والأمن، وسجلات القرارات المعمارية (ADRs) |
الإضافات: امتدادات جاهزة للدمج
نظام إضافات بسيط: أضف الإضافة وسترتبط مباشرة بأحداث Maggy. يأتي مزودا بعدة إضافات جاهزة للاستخدام.
يحوّل العمل المنجز إلى منشورات وينشرها على LinkedIn و X و Reddit، مع محرك نبرة صوتية (نص عادي، بلا شرطات طويلة) ونبض دوري للرد على التعليقات.
تربط موفرات GitHub وAsana وMonday المهام والمشكلات مباشرةً داخل الـ harness.
يأتي Telos كإضافة برمجية؛ اكتب إضافتك الخاصة عبر ملفَي plugin.yaml و plugin.py بسيطين.
ما الذي يميز Maggy
معظم أدوات "هندسة الذكاء الاصطناعي" هي إما حلقة وكيل مستقل (على غرار Hermes) تستبدل واجهة سطر الأوامر (CLI) لديك، أو غلاف سطحي لا يضيف شيئًا. أما Maggy فهو طبقة انضباط وتوجيه تعزز الأدوات التي تستخدمها بالفعل.
| القدرة | Maggy | أطر عمل الوكلاء المستقلين | Claude Code الخام |
|---|---|---|---|
| توجيه متعدد النماذج | نعم: 13 فئة، أرخص نموذج مقتدر | عادةً نموذج واحد / حلقة خاصة بك (BYO) | لا: نموذج واحد لكل شيء |
| انضباط مفروض | نقاط إيقاف TDD + بوابات الجودة + ADRs | اختياري، يعتمد على التلقين | لا يوجد |
| ذاكرة عابرة للجلسات | Engram / Mnemos، تدوم بعد ضغط السياق | نادر / إضافة خارجية لمخزن متجهات | تُفقد مع كل جلسة |
| ذكاء الكود | iCPG + Cortex MCP (لماذا وُجد الكود) | عادةً RAG بسيط على الملفات | لا يوجد |
| أمان التنفيذ المتوازي | Polyphony، مساحات عمل معزولة عبر Docker | يدوي / تعارضات في المستودع المشترك | غير متاح |
| يعمل مع واجهة سطر الأوامر (CLI) لديك | يعزز Claude Code / Codex / Kimi / Gemini | يستبدل أدواتك بأدواته الخاصة | غير متاح |
| مفتوح المصدر | ترخيص MIT، أكثر من 1100 اختبار، قابل للاستضافة الذاتية | يتفاوت | مغلق |
كيف يبدو
You: "review the auth middleware for timing attacks" → Blast score: 8/10 (security + architecture) → Routed to: Claude (Tier 12) → ADR gate: found docs/adr/0003-jwt-strategy.md → injected as context → Review runs with full architectural context You: "push to git" → Intent matched: git-push protocol → ✅ lint · ✅ typecheck · ✅ tests · ✅ commit (AI-written) · ✅ push
Maggy وpalgu>
إنهما يتكاملان معاً. Maggy هو agent harness مفتوح المصدر لمطور واحد: محلي، ومجاني، يختار النموذج المناسب ويفرض الانضباط الهندسي. أما palgu> فهو superharness الهندسي المتكامل للفريق: يدير العمليات الهندسية عبر كل وكيل ونموذج، مع الميزانيات والسياسات وسجلات التدقيق التي تحتاجها المؤسسة. وجّه Claude Code إلى أي منهما؛ استخدم Maggy بمفردك مجاناً، وأضف palgu> عندما يحتاج الفريق إلى الحوكمة. كلاهما لا يقيدك.