منصوبے کے بارے میں

Beats PM Kit (Beats Agentic PM Harness) ایک OfficeBeats پروجیکٹ ہے جو شواہد پر مبنی پروڈکٹ مینجمنٹ ورک فلو کے لیے لوکل-فرسٹ، کراس-رن ٹائم ہارنس پیک کرتا ہے۔ یہ بکھرے ہوئے پروڈکٹ سیاق و سباق — میٹنگز، چیٹ تھریڈز، ای میل، دستاویزات اور نوٹس — کو مقامی طور پر سادہ مارک ڈاؤن کے طور پر محفوظ کرتا ہے، انہیں قابلِ تلاش بناتا ہے، اور انہیں ورک اسٹریمز اور ٹاسکس میں ترتیب دیتا ہے جن پر AI ایجنٹ عمل کر سکے۔ README کے مطابق کٹ خود کچھ اپ لوڈ نہیں کرتا۔ ساخت اور تصورات کٹ نمبر شدہ والٹ ٹیکسونومی استعمال کرتا ہے: 0. Incoming، 1. Company، 2. Products، 3. Meetings، 4. People، 5. Trackers، 6. Resources، 6. SOPs، 7. Partners، 8. Clients، نیز .agent/ کینونیکل ایجنٹس، قواعد، اسکلز، ٹیمپلیٹس اور ورک فلو کے لیے، اور system/ اسکرپٹس، ٹیسٹس اور دستاویزات کے لیے۔ کینونیکل ٹاسک اسٹیٹ 5. Trackers/tasks/ میں انسانی پڑھنے کے قابل مارک ڈاؤن نوٹس کے طور پر مستحکم IDs، شواہد کے لنکس، پیش رفت اور فیصلوں کے ساتھ رہتی ہے؛ TASK_MASTER.md اور ورک اسٹریم نوٹس کو ان فائلوں پر جنریٹڈ نیویگیشن بتایا گیا ہے، نہ کہ دوسرا سورس آف ٹروتھ۔ واحد سورس آف ٹروتھ .agent/command-registry.json روٹنگ، عرفی ناموں، ایگزیکیوشن پروفائلز اور رن ٹائم پالیسی کا مالک ہے؛ .agent/workflows/ ورک فلو رویے کا؛ .agent/skills/ دوبارہ استعمال کے قابل PM طریقوں کا۔ روٹ اڈاپٹر فائلیں (AGENTS.md، CLAUDE.md، GEMINI.md، CODEX_COMMANDS.md)، .omp/config.yml اور ٹول اگنور فائلیں system/scripts/sync_cli_adapters.py کے ذریعے تیار کردہ ویوز ہیں — .agent/ میں ترمیم کر کے دوبارہ جنریٹ کرنا مطلوبہ راستہ ہے، کیونکہ ہاتھ سے ایڈٹ کی گئی جنریٹڈ فائلیں ڈیزائن کے مطابق اوور رائٹ ہو جاتی ہیں۔ کمانڈز اور سیاق و سباق ہر سلیش کمانڈ رجسٹری کے ذریعے ایک ورک فلو فائل اور ایک ایگزیکیوشن پروفائل (Fast، Balanced یا Deep) میں حل ہوتی ہے، اور فی رن ٹائم پروموشن لیول رکھتی ہے: پروموٹڈ کمانڈز نیٹو اسکلز کے طور پر آتی ہیں، گارڈڈ کمانڈز کو تصدیق درکار ہوتی ہے، اور باقی صرف ڈسپیچ کے لیے ہیں۔ دستاویزی ایگزیکیوشن لوپ ہے: روٹ، محدود سیاق لوڈ، ٹولز کے ساتھ عمل، چیک پوائنٹ، تصدیق، آرٹیفیکٹ محفوظ؛ ابتدائی ریٹریول محدود ہے اور خام شواہد مقامی طور پر ہیش-ایڈریس ایبل رہتے ہیں، کمپیکٹ شدہ سیاق ماخذ فائلوں تک قابلِ سراغ ہے۔ معاون رن ٹائمز انٹری پوائنٹس omp، Claude Code، OpenAI Codex CLI، Google Antigravity، Gemini CLI، GitHub Copilot، اور اسی والٹ پر اختیاری Obsidian UI کے لیے درج ہیں۔ README کہتا ہے کہ رویہ پرووائیڈر درجہ بندی کے بجائے مثبت طور پر شناخت شدہ صلاحیتوں سے منتخب ہوتا ہے، ماڈل ڈیفالٹس رن ٹائم سے وراثت میں ملتے ہیں، اور نامعلوم صلاحیتیں فیل کلوز ہوتی ہیں۔ شروعات اور ورک فلو سیٹ اپ ایک git clone اور ./install.sh ہے، جو python3 system/scripts/bootstrap.py --agent --non-interactive کے گرد ایک پتلا ریپر ہے۔ Bootstrap ریپو کی تصدیق کرتا ہے، موجودہ ورک اسپیسز پر اپ گریڈ-کمپیٹیبلٹی گیٹ چلاتا ہے، اگنورڈ لوکل ورک اسپیس فولڈرز بناتا ہے، ٹیمپلیٹس سیڈ کرتا ہے، رن ٹائم اڈاپٹرز سنک کرتا ہے، ممکن ہو تو git hooks انسٹال کرتا ہے، اور پرائیویسی اور اڈاپٹر ہیلتھ چیکس چلاتا ہے۔ پھر صارف رن ٹائم میں فولڈر کھول کر /start یا /help چلاتا ہے۔ ورک فلو گروپس: intake اور شواہد (/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)۔ قدرتی زبان کا ان پٹ بھی معاون ہے۔ لوکل یوٹیلیٹیز دہرائے جانے والے کام system/scripts/ میں صرف stdlib والی Python اسکرپٹس کے سپرد ہیں، بشمول vault_query.py ٹاسکس، لیبلز اور اقتباسات پر محدود ریڈ-اونلی کوئریز کے لیے؛ context_router.py مقامی شواہد فولڈرز میں انڈیکسڈ فل ٹیکسٹ ریٹریول کے لیے؛ task_store.py اور task_intake_fast.py کینونیکل ٹاسک نوٹ رائٹس اور تیز intake کے لیے؛ transcript_pipeline.py میٹنگ ٹرانسکرپٹس کی تیاری، توثیق اور پروسیسنگ کے لیے؛ pm_decision_router.py ایگزیکیوشن سے پہلے بے ترتیب PM ان پٹ کی درجہ بندی کے لیے؛ obsidian_bridge.py کٹ فولڈر کو Obsidian والٹ کے طور پر استعمال کرنے کے لیے؛ pack_manager.py Trello جیسی غیر فعال اختیاری صلاحیتوں کو فعال کرنے کے لیے؛ upgrade_compat.py پری فلائٹ اور لیگیسی کنفیگریشنز کی reversible migration کے لیے؛ اور privacy_guard.py / adapter_guard.py نجی مواد کے اخراج اور جنریٹڈ اڈاپٹر ڈرفٹ کو روکنے کے لیے۔ پرائیویسی اور ٹیسٹنگ پرائیویسی رویہ لوکل-فرسٹ ہے: ذاتی والٹ فولڈرز gitignored ہیں اور صرف skeleton .gitkeep فائلوں کے ذریعے ٹریک ہوتے ہیں، مقامی رن ٹائم اسٹیٹ اگنورڈ .beats/ میں۔ گارڈ اسکرپٹس (privacy_guard.py --tree، adapter_guard.py --mode check) مشترکہ commits سے نجی مواد، ذاتی راستے، ٹوکن جیسی strings، ٹرانسکرپٹس اور اڈاپٹر ڈرفٹ روکتے ہیں۔ WATCHDOG.md ایڈوائزر قواعد متعین کرتا ہے جیسے من گھڑت اقتباسات، IDs یا تاریخیں نہیں، آؤٹ باؤنڈ بھیجنے کے لیے صارف کی واضح منظوری، اور ٹاسک اسٹیٹ کینونیکل ٹریکرز میں رکھنا۔ README یہ انتباہ بھی دیتا ہے کہ کٹ فائلیں کبھی کلاؤڈ سروس پر سنک نہیں کرتا، مگر منتخب کردہ AI رن ٹائم پرامپٹس اور ٹول آؤٹ پٹس کو اسی پرووائیڈر کی اپنی سیٹنگز کے تحت پروسیس کرتا ہے۔ ٹیسٹس system/tests/ میں pytest انداز میں ہیں اور رجسٹری، اڈاپٹرز، ٹاسک اسٹور، ٹرانسکرپٹ پائپ لائن، پرائیویسی اور اڈاپٹر گارڈز، اپ گریڈ کمپیٹیبلٹی اور والٹ انویریئنٹس کا احاطہ کرتے ہیں۔ کریڈٹس Beats PM Kit روزمرہ پروڈکٹ کام سے بنایا گیا ہے؛ ایکشن-فرسٹ آؤٹ پٹ پالیسی کو MIT-لائسنس یافتہ i-have-adhd پروجیکٹ سے متاثر ایک آزادانہ طور پر تحریر شدہ نقطہ نظر بتایا گیا ہے، جس میں کوئی اپ اسٹریم پلگ ان یا ہک کوڈ شامل نہیں۔