इस प्रोजेक्ट के बारे में

Beats PM Kit (Beats Agentic PM Harness) एक OfficeBeats प्रोजेक्ट है जो साक्ष्य-आधारित उत्पाद-प्रबंधन वर्कफ़्लो के लिए लोकल-फर्स्ट, क्रॉस-रनटाइम हार्नेस पैकेज करता है। यह बिखरे हुए उत्पाद संदर्भ — मीटिंग्स, चैट थ्रेड्स, ईमेल, दस्तावेज़ और नोट्स — को स्थानीय रूप से सादे Markdown के रूप में संग्रहीत करता है, उन्हें खोजने योग्य बनाता है, और उन्हें वर्कस्ट्रीम और कार्यों में त्रिभुजित करता है जिन पर एक 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, साक्ष्य लिंक, प्रगति और निर्णयों वाले मानव-पठनीय Markdown नोट्स के रूप में रहती है; 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 चलाते हैं। वर्कफ़्लो को समूहों में बाँटा गया है: इनटेक और साक्ष्य (/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 कैनोनिकल कार्य-नोट लेखन और तेज़ इनटेक के लिए; transcript_pipeline.py मीटिंग ट्रांसक्रिप्ट तैयार करने, सत्यापित करने और संसाधित करने के लिए; pm_decision_router.py निष्पादन से पहले अव्यवस्थित PM इनपुट को वर्गीकृत करने के लिए; obsidian_bridge.py किट फ़ोल्डर को Obsidian वॉल्ट के रूप में उपयोग करने के लिए; pack_manager.py Trello जैसी निष्क्रिय वैकल्पिक क्षमताओं को सक्षम करने के लिए; upgrade_compat.py लीगेसी कॉन्फ़िगरेशन के प्रीफ़्लाइट और प्रतिवर्ती माइग्रेशन के लिए; और privacy_guard.py / adapter_guard.py निजी-सामग्री लीक और उत्पन्न-एडाप्टर ड्रिफ्ट को रोकने के लिए। प्राइवेसी और परीक्षण प्राइवेसी रुख लोकल-फर्स्ट है: व्यक्तिगत वॉल्ट फ़ोल्डर gitignored हैं और केवल स्केलेटन .gitkeep फ़ाइलों के माध्यम से ट्रैक किए जाते हैं, स्थानीय रनटाइम स्थिति एक इग्नोर किए गए .beats/ में रहती है। गार्ड स्क्रिप्ट (privacy_guard.py --tree, adapter_guard.py --mode check) साझा कमिट से निजी सामग्री, व्यक्तिगत पथ, टोकन-जैसी स्ट्रिंग्स, ट्रांसक्रिप्ट और एडाप्टर ड्रिफ्ट को रोकती हैं। WATCHDOG.md सलाहकार नियम परिभाषित करता है जैसे कि कोई मनगढ़ंत उद्धरण, IDs या तारीखें नहीं, आउटबाउंड भेजने के लिए स्पष्ट उपयोगकर्ता अनुमोदन, और कार्य स्थिति को कैनोनिकल ट्रैकर्स में रखना। README यह चेतावनी जोड़ता है कि किट कभी भी फ़ाइलों को क्लाउड सेवा से सिंक नहीं करता, लेकिन चुना गया AI रनटाइम उस प्रदाता की अपनी सेटिंग्स के तहत प्रॉम्प्ट और टूल आउटपुट संसाधित करता है। टेस्ट system/tests/ में pytest शैली में रहते हैं और रजिस्ट्री, एडाप्टर, टास्क स्टोर, ट्रांसक्रिप्ट पाइपलाइन, प्राइवेसी और एडाप्टर गार्ड, अपग्रेड संगतता और वॉल्ट इनवेरिएंट को कवर करते हैं। श्रेय Beats PM Kit दैनिक उत्पाद कार्य से बना है; एक्शन-फर्स्ट आउटपुट नीति को MIT-लाइसेंस प्राप्त i-have-adhd प्रोजेक्ट से प्रेरित एक स्वतंत्र रूप से शब्दांकित दृष्टिकोण बताया गया है, जिसमें कोई अपस्ट्रीम प्लगइन या हुक कोड बंडल नहीं है।