عن المشروع

Beats PM Kit (حزمة Beats Agentic PM) هي مشروع من OfficeBeats يجمع حزمة محلية أولية ومتعددة البيئات لسير عمل إدارة المنتج المدعوم بالأدلة. وهي تقوم بردم السياق المتناثر للمنتج — الاجتماعات، سلاسل الدردشة، البريد الإلكتروني، المستندات والملاحظات — كـ Markdown عادي محليًا، وتجعله قابلًا للبحث، وتستخرج منه سير عمل ومهام يمكن لوكيل AI تنفيذها. يذكر README أن الحزمة نفسها لا تقوم برفع أي شيء. الهيكل والمفاهيم تستخدم الحزمة تصنيفًا رقميًا لـ Vault: 0. وارد، 1. الشركة، 2. المنتجات، 3. الاجتماعات، 4. الأشخاص، 5. المتتبعون، 6. الموارد، 6. SOPs، 7. الشركاء، 8. العملاء، بالإضافة إلى .agent/ للوكلاء المركزيين، القواعد، المهارات، القوالب وسير العمل، وsystem/ للنصوص، الاختبارات والوثائق. تعيش حالة المهام المركزية في 5. Trackers/tasks/ كملاحظات Markdown قابلة للقراءة البشرية مع معرفات ثابتة، روابط الأدلة، التقدم والقرارات؛ يُوصف TASK_MASTER.md وملاحظات سير العمل بأنها عمليات تصفح منشأة فوق تلك الملفات، وليست مصدرًا ثانيًا للحقيقة. المصدر الوحيد للحقيقة يملك .agent/command-registry.json التوجيه، الألقاب، ملفات تعريف التنفيذ وسياسة البيئة؛ يملك .agent/workflows/ سلوك سير العمل؛ يملك .agent/skills/ طرق إدارة المنتج القابلة لإعادة الاستخدام. تُنشأ ملفات المحول الجذرية (AGENTS.md، CLAUDE.md، GEMINI.md، CODEX_COMMANDS.md)، و.omp/config.yml وملفات تجاهل الأدوات بواسطة system/scripts/sync_cli_adapters.py — الطريق المقصود هو تحرير .agent/ وإعادة التوليد، لأن الملفات المنشأة التي تم تحريرها يدويًا تُستبدل حسب التصميم. الأوامر والسياق يتم حل كل أمر / عبر السجل إلى ملف سير عمل واحد وملف تعريف تنفيذ واحد (سريع، متوازن أو عميق)، ويحمل مستوى ترقية لكل بيئة: الأوامر المرقاة تُشحن كمهارات أصلية، الأوامر المحمية تتطلب تأكيدًا، والباقي هو إرسال فقط. حلقة التنفيذ الموثقة هي التوجيه، تحميل السياق المحدود، التصرف بالأدوات، نقطة التفتيش، التحقق، حفظ القطعة؛ يتم تقييد الاسترجاع الأولي، ويظل الدليل الخام قابلًا للعنونة بالتجزئة محليًا، مع سياق مضغوط يمكن تتبعه إلى ملفات المصدر. بيئات التشغيل المدعومة يتم سرد نقاط الدخول لـ omp، Claude Code، OpenAI Codex CLI، Google Antigravity، Gemini CLI، GitHub Copilot، وواجهة Obsidian UI اختيارية فوق نفس الـ Vault. يذكر README أن السلوك يتم اختياره بواسطة الكشف الإيجابي للقدرات، وليس تسلسلًا هرميًا للمزود، وتُورث افتراضات النموذج من البيئة، وتفشل القدرات غير المعروفة بشكل مغلق. البدء وسير العمل الإعداد هو استنساخ git بالإضافة إلى ./install.sh، وهو غلاف رقيق حول python3 system/scripts/bootstrap.py --agent --non-interactive. يقوم Bootstrap بالتحقق من المستودع، وتشغيل بوابة توافق الترقية على مساحات العمل الموجودة، وإنشاء مجلدات مساحة عمل محلية متجاهلة، وزرع القوالب، ومزامنة محولات البيئة، وتثبيت خطافات git عندما يكون ذلك ممكنًا، وتشغيل فحوصات الخصوصية وصحة المحول. ثم يفتح المستخدمون المجلد في بيئة تشغيل ويشغلون /start أو /help. سير العمل مقسم إلى الاستقبال والأدلة (/paste، /find، /memory، /context، /chat وتكاملات المراسلة)، الاجتماعات (/meet، /transcript، /prep، /boss)، التخطيط والاستراتيجية (/plan، /create، /deck، /discover، /interview، /intel، /prioritize، /sprint، /retro)، التتبع (/track، /day، /week، /handoff)، الاتصالات والمستندات (/sop، /office-cli، /review، /challenge، /improve-plan)، الجودة والصيانة (/accuracy، /regression، /build، /vibe، /maintain، /update، /vacuum، /archive) والإعداد/التنسيق (/start، /help، /obsidian، /pack، /team، /fan-out). يتم دعم الإدخال باللغة الطبيعية أيضًا. الأدوات المحلية يتم تفويض العمل القابل للتكرار إلى نصوص Python فقط في system/scripts/، بما في ذلك vault_query.py لاستعلامات القراءة فقط المحدودة فوق المهام، الملصقات والاقتباسات؛ context_router.py لاسترجاع النص الكامل المفهرس عبر مجلدات الأدلة المحلية؛ task_store.py وtask_intake_fast.py لكتابة ملاحظات المهام المركزية والاستقبال السريع؛ transcript_pipeline.py لتحضير، التحقق ومعالجة نسخ الاجتماعات؛ pm_decision_router.py لتصنيف إدخال PM الفوضوي قبل التنفيذ؛ obsidian_bridge.py لاستخدام مجلد الحزمة كـ Vault لـ Obsidian؛ pack_manager.py لتمكين القدرات الاختيارية الخاملة مثل Trello؛ upgrade_compat.py للتحقق المسبق والترقية القابلة للعكس للتكوينات القديمة؛ وprivacy_guard.py / adapter_guard.py لمنع تسرب المحتوى الخاص وانحراف المحول المنشأ. الخصوصية والاختبار الوضعية الخاصة بالخصوصية هي محلية أولية: يتم تجاهل مجلدات Vault الشخصية بواسطة git وتتبعها فقط من خلال ملفات .gitkeep الهيكلية، مع حالة البيئة المحلية في .beats/ المتجاهلة. تمنع نصوص الحراسة (privacy_guard.py --tree، adapter_guard.py --mode check) المحتوى الخاص، المسارات الشخصية، السلاسل الشبيهة بالرمز، النسخ وانحراف المحول من الالتزامات المشتركة. يحدد WATCHDOG.md قواعد المستشار مثل عدم وجود اقتباسات، معرفات أو تواريخ مفبركة، الموافقة الصريحة للمستخدم على الإرسال الخارجي، والحفاظ على حالة المهام في المتتبعون المركزيون. يضيف README التحذير بأن الحزمة لا تقوم بمزامنة الملفات إلى خدمة سحابية، لكن بيئة AI المختارة تعالج المطالبات ومخرجات الأدوات تحت إعدادات ذلك المزود. تعيش الاختبارات في system/tests/ بأسلوب pytest وتغطي السجل، المحولات، متجر المهام، خط أنابيب النسخ، حراسة الخصوصية والمحول، توافق الترقية وثوابت الـ Vault. الاعتمادات تم بناء Beats PM Kit من عمل إدارة المنتج اليومي؛ يُوصف نهج المخرجات الأولية بالعمل بأنه نهج مستقل مستوحى من مشروع i-have-adhd المرخص تحت MIT، دون تضمين أي مكون إضافي أو رمز خطاف من المنبع.