عن المشروع

Genie هي طبقة تخطيط وتنفيذ عبر سطر الأوامر لوكلاء البرمجة بالذكاء الاصطناعي. الفكرة هي "طلبات تدخل، طلبات سحب تخرج": تصف ما تريده في جملة، ثم يُجري Genie مقابلة معك لتحويلها إلى خطة، ويوزع وكلاء لبنائها بالتوازي، ويراجع النتيجة مقابل معايير القبول، ويعيد شيئًا جاهزًا للدمج. البنية بسيطة عمدًا. لا توجد برامج خفية ولا Postgres: الجسم عبارة عن مجموعة مهارات، مستندات نصية عادية مخزنة في git، وملف SQLite واحد لكل مستودع (`.genie/genie.db`) على محرك Bun المدمج. يفتح الأمر قاعدة البيانات، وينفذ معاملة واحدة، ويخرج. يُوصف الحزمة بأنها حوالي 0.9 ميجابايت مع أربع تبعيات وقت تشغيل، و`nats` لا يُهيأ إلا عند بدء مشغل Omni. التثبيت هو سكربت شل يُنفذ عبر curl. الإصدارات موقعة بـ cosign مع إثبات SLSA، ويقوم المثبت بالتحقق من الثنائي عبر `gh attestation verify` مع بديل `cosign verify-blob`. تتوفر ثلاث واجهات: الثنائي الموقع، المهارات (تُسلم عبر قناة skills.sh، أو عبر `npx skills add automagik-dev/genie`)، وإضافة Orca اختيارية مسجلة على جانب Orca. سير العمل مدفوع بالمهارات: `brainstorm` (من فكرة إلى DESIGN.md مع مراجعة تصميم)، `wish` (من تصميم إلى WISH.md محدد مع مجموعات تنفيذ)، `review` (مراجعة خطة إلزامية)، `work` (وكلاء فرعيون بأدوار أصلية يبنون كل مجموعة معتمدة)، ومراجعة تنفيذ مستقلة نهائية تُرجع SHIP أو FIX-FIRST أو BLOCKED. تُكتب المهارات بشكل محايد لوقت التشغيل وتُثبت في كل منزل مهارات مكتشف للوكيل (Claude Code، منزل `~/.agents/skills` المشترك المستخدم من Codex وغيرهم، Goose، Windsurf). تُفصل الحالة والمستندات: الطلبات والتصاميم والعصف الذهني هي markdown تحت `.genie/`، بينما المهام واللوحات وتبعيات الحواف وحالة التنفيذ في SQLite. أشجار العمل المرتبطة لمستودع تشارك قاعدة بيانات واحدة تُحل من دليل git المشترك، لذا تكون المهام مرئية عبر أشجار العمل دون خطوة مزامنة. أمر `genie context` يُصدر JSON مُصدرًا يصف سياق الإطلاق (الفرع، SHA الأساسي، المهام الجاهزة). Genie له وضعان لدورة الحياة. `standalone` هو الافتراضي؛ `genie setup --orchestration-mode orca` يجعل Orca السلطة الوحيدة لدورة الحياة بعد التحقق من وقت تشغيل متوافق، وفي هذا الوضع يرفض Genie قراءات/كتابات دورة الحياة المحلية بدلاً من التراجع بصمت. خادم MCP القديم وجسر واجهة المستخدم متقاعدان، مع خروج `genie mcp` و`genie ui-bridge` برمز غير صفري مع تشخيصات ثابتة. جسر `genie omni` اختياري يربط وكيلًا يعمل بـ WhatsApp عبر مركز Omni عبر NATS للموافقات عن بُعد والرسائل الواردة لمرة واحدة. تفاصيل تشغيلية ملحوظة: `genie doctor` يُبلغ عن صحة التثبيت ووجود المهارات لكل وكيل؛ `genie update` يتعامل مع تقاعد بقايا عصر الإضافات بأولوية النسخ الاحتياطي، محافظًا على الأصول المعدلة أو الغامضة؛ `genie uninstall` يحذف فقط الأصول التي يمكنه إثبات أنها مملوكة لـ Genie. يوضح README أن رحلة WhatsApp الحية هي خطوة QA يدوية موثقة، بينما يُتحقق من سلوك Omni ضد نقل مزيف في مجموعة الاختبار.